API Information

Response Format
XML
Service Action Code
PaymentRQ, PaymentRS
Current Version
4.9.0
Target Audience
Both TN and AS
Environment
Production
Documentation
Go to the Payment documentation

What's New

  • New optional attribute "EncryptedCardNumber" added in PaymentCard element of PaymentRQ: /PaymentRQ/PaymentDetail/PaymentCard/@EncryptedCardNumber
  • New optional attribute "CAVV" added in T3DS_Result element of PaymentRS: /PaymentRS/AuthorizationResult/T3DS_Result/@CAVV
  • New optional attribute "XID" added in T3DS_Result element of PaymentRS: /PaymentRS/AuthorizationResult/T3DS_Result/@XID
  • New optional attribute POS_EntryMode added in AuthResponseDetail element of PaymentRS: PaymentRS/AuthorizationResult/AuthResponseDetail/@POS_EntryMode
  • New optional attribute POS_AdditionalData added in AuthResponseDetail element of PaymentRS: PaymentRS/AuthorizationResult/AuthResponseDetail/@POS_AdditionalData
  • New optional attribute POS_ConditionCode added in AuthResponseDetail element of PaymentRS: PaymentRS/AuthorizationResult/AuthResponseDetail/@POS_ConditionCode
  • New optional attribute TIC added in AuthResponseDetail element of PaymentRS: PaymentRS/AuthorizationResult/AuthResponseDetail/@TIC
  • New optional attribute MCC added in AuthResponseDetail element of PaymentRS: PaymentRS/AuthorizationResult/AuthResponseDetail/@MCC
  • New optional attribute SpendQualifiedInd added in AuthResponseDetail element of PaymentRS: PaymentRS/AuthorizationResult/AuthResponseDetail/@SpendQualifiedInd

New Features

In the Request

Optional

Parameter: EncryptedCardNumber

Type: String

Description: Card number which will come in Notifications for Payment Service Providers.

Sample Value:

<PaymentCard CardCode="BT" CardNumber="898400######5894" CardSecurityCode="XXX" T3DS_Ind="false" ExpireDate="######" ExtendPayment="00" EncryptedCardNumber="39A494DBA5D015A172E1AA03A0D3CD87"> <CardHolderName Name="PHIL FLIEGER" /> <Authenticated>false</Authenticated> </PaymentCard>

In the Response

Optional

Parameter: CAVV

Type: String

Description: A string token provided by Issuing bank as a response from 3DSecure authentication request for Verified By Visa or MasterCard Secure Code.

Sample Value:

<T3DS_Result ECI="05" CAVV="CASDFEWESFSDF" XID="ABCDED" ECI_ResultCode="Y" UCAF_ResultCode="ab34fdf4341fk3j5454h4343ffeeerer"/>
Parameter: XID

Type: String

Description: American Express SafeKey Transaction ID

Sample Value:

<T3DS_Result ECI="05" CAVV="CASDFEWESFSDF" XID="ABCDED" ECI_ResultCode="Y" UCAF_ResultCode="ab34fdf4341fk3j5454h4343ffeeerer"/>
Parameter: POS_EntryMode

Type: String

Description: Point of Sale Entry Mode

Sample Value:

<AuthResponseDetail AuthSrcCode="4" AuthValidationCode="6N8D" ProductID="A" AuthCharacteristicInd="V" POS_ConditionCode="08" POS_AdditionalData="400000000000" POS_EntryMode="Y" TIC="U0" MCC="3000" SpendQualifiedInd="Z"/>
Parameter: POS_ConditionCode

Type: String

Description: Point of Sale Condition Code

Sample Value:

<AuthResponseDetail AuthSrcCode="4" AuthValidationCode="6N8D" ProductID="A" AuthCharacteristicInd="V" POS_ConditionCode="08" POS_AdditionalData="400000000000" POS_EntryMode="Y" TIC="U0" MCC="3000" SpendQualifiedInd="Z"/>
Parameter: POS_AdditionalData

Type: String

Description: Point of Sale Additional Data

Sample Value:

<AuthResponseDetail AuthSrcCode="4" AuthValidationCode="6N8D" ProductID="A" AuthCharacteristicInd="V" POS_ConditionCode="08" POS_AdditionalData="400000000000" POS_EntryMode="Y" TIC="U0" MCC="3000" SpendQualifiedInd="Z"/>
Parameter: TIC

Type: String

Description: MasterCard Transaction Integrity Classification

Sample Value:

<AuthResponseDetail AuthSrcCode="4" AuthValidationCode="6N8D" ProductID="A" AuthCharacteristicInd="V" POS_ConditionCode="08" POS_AdditionalData="400000000000" POS_EntryMode="Y" TIC="U0" MCC="3000" SpendQualifiedInd="Z"/>
Parameter: MCC

Type: String

Description: Merchant Category Code

Sample Value:

<AuthResponseDetail AuthSrcCode="4" AuthValidationCode="6N8D" ProductID="A" AuthCharacteristicInd="V" POS_ConditionCode="08" POS_AdditionalData="400000000000" POS_EntryMode="Y" TIC="U0" MCC="3000" SpendQualifiedInd="Z"/>
Parameter: SpendQualifiedInd

Type: String

Description: Spend Qualified Indicator

Sample Value:

<AuthResponseDetail AuthSrcCode="4" AuthValidationCode="6N8D" ProductID="A" AuthCharacteristicInd="V" POS_ConditionCode="08" POS_AdditionalData="400000000000" POS_EntryMode="Y" TIC="U0" MCC="3000" SpendQualifiedInd="Z"/>