View source for X-Payments:Detailed payment and transaction information request

<noinclude>{{XP_API_TOC}}</noinclude>

Starting from API version 1.9, the Detailed payment and transaction information request and response are identical to the [[X-Payments:Payment_information_request | Payment information request and response]].


===Request specification===

{| cellspacing="0" cellpadding="2" border="1"
| colspan="1" | '''Field'''
| colspan="1" | '''Required'''
| colspan="1" | '''Type'''
| colspan="1" | '''Description'''
|-
| colspan="1" | target
| colspan="1" | Y
| colspan="1" | string, 128
| colspan="1" | Must equal payment
|-
| colspan="1" | action
| colspan="1" | Y
| colspan="1" | string, 128
| colspan="1" | Must equal get_additional_info
|-
| colspan="1" | txnId
| colspan="1" | Y
| colspan="1" | string, 32
| colspan="1" | A unique payment ID received in the payment initialisation request response
|-
| colspan="1" | refresh
| colspan="1" | N
| colspan="1" | 0 or 1
| colspan="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
|-
| colspan="1" | api_version
| colspan="1" | Y
| colspan="1" | string
| colspan="1" | Must equal one of the following: 1.2, 1.3, 1.4, 1.5 etc.
|}

===Request example===

<pre>
<api_version>1.7</api_version>
<target>payment</target>
<action>get_additional_info</action>
<txnId>90d7b9e5834b6c0d817f5f3550756ed9</txnId>
</pre>

===Response specification===

{| cellspacing="0" cellpadding="2" border="1"
| colspan="1" | '''Field'''
| colspan="1" | '''Type'''
| colspan="1" | '''Description'''
|-
| colspan="1" | payment
| colspan="1" | container
| colspan="1" | See [[X-Payments:Payment_information_request | Payment information request]]
|-
| colspan="1" | transactions
| colspan="1" | container
| colspan="1" | Transaction list
|-
| colspan="1" | transactions/date
| colspan="1" | integer, 11
| colspan="1" | Transaction date (Unix timestamp)
|-
| colspan="1" | transactions/action
| colspan="1" | string, 255
| colspan="1" | Transaction name. In API 1.8, for consecutive identical transactions a note "(X attempts)" is added to this field, where X is the number of repetitive transactions. 
| colspan="1" | transactions/status
| colspan="1" | string, 255
| colspan="1" | Transaction status
|-
| colspan="1" | transactions/message
| colspan="1" | string, 65536
| colspan="1" | Gateway transaction message
|-
| colspan="1" | transactions/total
| colspan="1" | string, 32
| colspan="1" | Transaction amount and currency
|-
| colspan="1" | transactions/txnid
| colspan="1" | string, 255
| colspan="1" | Gateway transaction unique ID
|-
| colspan="1" | transactions/payment_status
| colspan="1" | string, 255
| colspan="1" | The payment status after the transaction
|-
| colspan="1" | transactions/fields
| colspan="1" | container
| colspan="1" | Transaction additional fields list
|-
| colspan="1" | transactions/fields/name
| colspan="1" | string, 255
| colspan="1" | Field name
|-
| colspan="1" | transactions/fields/name
| colspan="1" | string, 255
| colspan="1" | Field value
|-
| colspan="1" | transactions/attempts
| colspan="1" | integer
| colspan="1" | Only available in API 1.9. Number of attempts of consecutive identical transactions. 
|-
|}

===Response example===

<pre>
<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 &gt; 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>
</pre>

<br />
''The following pertains to API 1.5 and later:''<br />
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:

{| cellspacing="0" cellpadding="2" border="1"
| colspan="1" | '''Field'''
| colspan="1" | '''Description'''
|-
| colspan="1"| [Kount] %%%%%, where %%%%% is some number
| colspan="1"| triggered rule, the number is the number of this rule
|-
| colspan="1"| [Kount] Auto
| colspan="1"| The status of the transaction in Kount ("R" - review, "D" - declined, "A" - approved)
|-
| colspan="1"| [Kount] Errors
| colspan="1"| list of errors (if any)
|-
| colspan="1"| [Kount] Warnings: 
| colspan="1"| list of warnings (if any)
|-
| colspan="1"| [Kount] Score
| colspan="1"|  Risk score
|-
| colspan="1"| [Kount] Transaction ID
| colspan="1"| 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
|}
<br />