Request specification
| Field
|
Required
|
Type
|
Description
|
| target
|
Y
|
string, 128
|
Must equal payment
|
| action
|
Y
|
string, 128
|
Must equal get_additional_info
|
| txnId
|
Y
|
string, 32
|
A unique payment ID received in the payment initialisation request response
|
| refresh
|
N
|
0 or 1
|
(Only API 1.9 and later) A flag specifying that the data in X-Payments must be overwritten by the data from the payment gateway. By default - 0
|
| api_version
|
Y
|
string
|
Must equal one of the following: 1.2, 1.3, 1.4, 1.5 etc.
|
Request example
<api_version>1.7</api_version>
<target>payment</target>
<action>get_additional_info</action>
<txnId>90d7b9e5834b6c0d817f5f3550756ed9</txnId>
Response specification
| Field
|
Type
|
Description
|
| payment
|
container
|
See Payment information request
|
| transactions
|
container
|
Transaction list
|
| transactions/date
|
integer, 11
|
Transaction date (Unix timestamp)
|
| transactions/action
|
string, 255
|
Transaction name
|
| transactions/status
|
string, 255
|
Transaction status
|
| transactions/message
|
string, 65536
|
Gateway transaction message
|
| transactions/total
|
string, 32
|
Transaction amount and currency
|
| transactions/txnid
|
string, 255
|
Gateway transaction unique ID
|
| transactions/payment_status
|
string, 255
|
The payment status after the transaction
|
| transactions/fields
|
container
|
Transaction additional fields list
|
| transactions/fields/name
|
string, 255
|
Field name
|
| transactions/fields/name
|
string, 255
|
Field value
|
Response example
<data>
<payment>
<status>4</status>
<message>Payment is charged</message>
<isFraudStatus>1</isFraudStatus>
<currency>USD</currency>
<amount>100.00</amount>
<authorized>0.00</authorized>
<chargedAmount>100.00</chargedAmount>
<capturedAmount>0.00</capturedAmount>
<capturedAmountAvail>0.00</capturedAmountAvail>
<voidedAmount>0.00</voidedAmount>
<voidedAmountAvail>0.00</voidedAmountAvail>
<refundedAmount>0.00</refundedAmount>
<refundedAmountAvail>100.00</refundedAmountAvail>
<fraudAuthorized>0.00</fraudAuthorized>
<fraudCharged>0.00</fraudCharged>
<authorizeInProgress>0.00</authorizeInProgress>
<chargeInProgress>0.00</chargeInProgress>
<advinfo>
<Message></Message>
<txn_id>12479</txn_id>
<AVS>1: Cardholder name matches</AVS>
<CVV2>M: CVV2 / CVC2/CVD Match.</CVV2>
</advinfo>
<transactionInProgress></transactionInProgress>
<capturedAmountAvailMin>0.00</capturedAmountAvailMin>
<capturedAmountAvailGateway>0.00</capturedAmountAvailGateway>
<capturedAmountAvailMinGateway>0.00</capturedAmountAvailMinGateway>
<voidedAmountAvailGateway>0.00</voidedAmountAvailGateway>
<refundedAmountAvailGateway>100.00</refundedAmountAvailGateway>
<cardValidation>
<avs_z>0</avs_z>
<avs_c>1</avs_c>
<avs_a>0</avs_a>
<cvv>1</cvv>
</cardValidation>
<maskedCardData>
<first6>411111</first6>
<last4>1111</last4>
<type>VISA</type>
<expire_month>11</expire_month>
<expire_year>2019</expire_year>
<cardholder_name></cardholder_name>
</maskedCardData>
<saveCard>Y</saveCard>
<3dsecure>
<s3d_enrolled></s3d_enrolled>
<s3d_eci></s3d_eci>
<s3d_cavv></s3d_cavv>
<s3d_xid></s3d_xid>
<s3d_pares></s3d_pares>
<s3d_error>N</s3d_error>
<s3d_message></s3d_message>
<s3d_txnid></s3d_txnid>
<s3d_authid></s3d_authid>
<s3d_int_reason>D</s3d_int_reason>
<s3d_orderid></s3d_orderid>
<cavv></cavv>
</3dsecure>
</payment>
<transactions type="cell">
<date>1478018226</date>
<action>Sale</action>
<status>Success</status>
<message>Transaction Normal</message>
<total>100 USD</total>
<txnid>116705738</txnid>
<fields type="cell">
<name>Authorization number</name>
<value>ET137771</value>
</fields>
<fields type="cell">
<name>AVS</name>
<value>1: Cardholder name matches</value>
</fields>
<fields type="cell">
<name>Bank message</name>
<value>Approved</value>
</fields>
<fields type="cell">
<name>Bank response code</name>
<value>100</value>
</fields>
<fields type="cell">
<name>CVV2</name>
<value>M: CVV2 / CVC2/CVD Match.</value>
</fields>
<fields type="cell">
<name>Processing status</name>
<value>Transaction Normal</value>
</fields>
<fields type="cell">
<name>Transarmor Token</name>
<value>0925049927141111</value>
</fields>
<fields type="cell">
<name>[Kount] 702650</name>
<value>Distance from Device to Billing > 1000km</value>
</fields>
<fields type="cell">
<name>[Kount] 702656</name>
<value>Billing Country not equal to BIN Country (Visa/MC)</value>
</fields>
<fields type="cell">
<name>[Kount] 702662</name>
<value>Billing Country not equal to Device Country</value>
</fields>
<fields type="cell">
<name>[Kount] Auto</name>
<value>R</value>
</fields>
<fields type="cell">
<name>[Kount] Score</name>
<value>41</value>
</fields>
<fields type="cell">
<name>[Kount] Transaction ID</name>
<value>P5460K3KNLLH</value>
</fields>
<fields type="cell">
<name>[NoFraud] Decision</name>
<value>pass</value>
</fields>
<fields type="cell">
<name>[NoFraud] Transaction ID</name>
<value>jjoegjgh</value>
</fields>
<payment_status>Charged</payment_status>
</transactions>
<error></error>
<error_message></error_message>
<is_error_message></is_error_message>
<version>3.0.2</version>
</data>
The following pertains to API 1.5 and later:
If the transaction was checked by Kount antifraud screening service, the "advinfo" and "tansaction/fields" containers contain information of kount results. The field names related to Kount start with the [Kount] prefix. The information can be extracted as follows:
| Field
|
Description
|
| [Kount] %%%%%, where %%%%% is some number
|
triggered rule, the number is the number of this rule
|
| [Kount] Auto
|
The status of the transaction in Kount ("R" - review, "D" - declined, "A" - approved)
|
| [Kount] Errors
|
list of errors (if any)
|
| [Kount] Warnings:
|
list of warnings (if any)
|
| [Kount] Score
|
Risk score
|
| [Kount] Transaction ID
|
Transaction ID in Kount, can be used to display the direct link to the transaction in Kount, https://awc.test.kount.net/workflow/detail.html?id=%%%%%% for test mode or https://awc.kount.net/workflow/detail.html?id=%%%%%%, where %%%%% should be replaced with the transaction ID
|
