Transaction Detail

Get Transaction Detail

GET https://<Platform-host>/api/merchant/:merchant_id/transaction/:transaction_id

Path Parameters

Name

Type

Description

merchant_id*

String

Merchant ID

transaction_id*

String

Transaction ID

data

object

Transaction detail group

data.id

string

Platform system ID for the sale request

Required

data.amount

string

Payment dollar value

Required

data.gratuity

string

The final gratuity amount, included in the transaction, associated with the purchase

Optional

data.details

array

Transaction details

data.details[i].id

string

Unique transactionID

Required

data.details[i].amount

string

Transaction amount

Required

data.details[i].data.last_4

string

Last 4 digits of credit card or bank account

Required

data.details[i].data.bank_account_id

string

Platform bank account ID associated with this transaction if `payment_method` is ACH

Optional

data.details[i].data.card_type

string

Credit card type used for the transaction if `payment_method` is Credit Card

Optional

data.details[i].data.card_id

string

Platform card id associated with this transaction if `payment_method` is Credit Card

Optional

data.details[i].host_report

Object

Refer to Credit Card Sale (SaleResponse) or ACH Sale (AchResponse) object definitions

Required

data.details[i].payment_method

string

Transaction payment method. Possible values `Credit Card` | `ACH` | `Offline - <method>`

Required

data.details[i].type

string

Transaction type Possible values `payment` | `refund`

Required

data.details[i].status

string

Platform transaction status Possible values `succeeded` | `failed` | `pending` | `cancelled` | `pending_3dsauth`

Required

data.details[i].created_at

string

Timestamp when the transaction was created

Required

data.details[i].updated_at

string

Timestamp when the transaction was last updated

Required

data.details[i].settled

boolean

Indicates whether this transaction has been settled or not

Required

data.details[i].is_offline

boolean

Indicates whether the transaction is offline type.

Required

data.details[i].threeeds_auth_data.acsOperatorID

string

Unique ID to each ACS on an individual basis

data.details[i].threeeds_auth_data.acsReferenceNumber

string

Unique identifier assigned by the EMVCo Secretariat upon Testing and Approval.

data.details[i].threeeds_auth_data.acsTransID

string

Universally unique transaction identifier assigned by the ACS to identify a single transaction

data.details[i].threeeds_auth_data.authenticationValue

string

Payment System-specific value provided by the ACS or the DS using an algorithm defined by Payment System. Authentication Value may be used to provide proof of authentication. Required if transStatus is one of [Y, A]

data.details[i].threeeds_auth_data.dsReferenceNumber

string

EMVCo-assigned unique identifier to track approved DS.

data.details[i].threeeds_auth_data.dsTransID

string

Universally unique transaction identifier assigned by the DS to identify a single transaction.

data.details[i].threeeds_auth_data.eci

string

Payment System-specific value provided by the ACS or DS to indicate the results of the attempt to authenticate the Cardholder.

data.details[i].threeeds_auth_data.messageType

string

Identifies the type of message that is passed

data.details[i].threeeds_auth_data.messageVersion

string

Protocol version identifier This shall be the Protocol Version Number of the specification utilised by the system creating this message

data.details[i].threeeds_auth_data.threeDSServerTransID

string

Universally unique transaction identifier assigned by the 3DS Server to identify a single transaction

data.details[i].threeeds_auth_data.transStatus

string

Indicates whether a transaction qualifies as an authenticated transaction or account verification. Y - Authentication/ Account Verification Successful N - Not Authenticated /Account Not Verified; Transaction denied U - Authentication/ Account Verification Could Not Be Performed; Technical or other problem, as indicated in ARes or RReq A - Attempts Processing Performed; Not Authenticated/Verified , but a proof of attempted authentication/verification is provided C - Challenge Required; Additional authentication is required using the CReq/CRes D - Challenge Required; Decoupled Authentication confirmed. R - Authentication/ Account Verification Rejected; Issuer is rejecting authentication/verification and request that authorisation not be attempted. I - Informational Only; 3DS Requestor challenge preference acknowledged.

data.details[i].threeeds_auth_data.liabilityShift

boolean

Yes for following conditions 1. transStatus is Y and eci is 05 2. transStatus is A and eci is 06 3. transStatus is Y and eci is 02 4. transStatus is A and eci is 01 No for other conditions

data.details[i].threeeds_auth_data.allowNoLiabilityShift

boolean

True / False

data.details[i].device

Object

Device Object. This would exist for device based transactions

Optional

data.details[i].device.id

string

Device ID

data.details[i].device.type

string

Device Type

data.details[i].device.name

string

Device Name

data.details[i].device.model

string

Device Model

data.details[i].device.serial_number

string

Device Serial Number

data.details[i].device.manufacturer

string

Device Manufacturer

data.details[i].device.app_version

string

Device App version

data.details[i].device.os

string

Device operating system

data.details[i].device.os_version

string

Device OS version

data.details[i].device.sdk_version

string

Device SDK Version

{
    "data": {
        "id": "20655494-8713-47d9-9553-ec2acd959a2e",
        "amount": "110.00",
        "gratuity":"10.00",
        "is_offline": false,
        "standalone": false,
        "isOverridenTransaction": false,
        "originalCardToken": "card_sandbox_8Aq30HAc8TLFUFvTjqwo556i",
        "refundable": true,
        "voidable": false,
        "details": [
            {
                "id": "b48cf399-9e32-4733-9145-c586e5cf3a74",
                "external_id": "35265177",
                "currency": "USD",
                "requested_currency": "USD",
                "amount": "110.00",
                "currency_conversion_rate": null,
                "requested_amount": "110.00",
                "data": {
                    "last_4": "1111",
                    "card_type": "visa",
                    "card_id": "d49d99e6-9b79-4f54-8284-d8f8054574c9",
                    "bank_account_id": null,
                    "sales_tax": "10.00",
                    "order_number": "Order124",
                    "first_name": "card holder",
                    "last_name": "name",
                    "customer_name": "John Doe",
                    "accounting_data": {
                        "salesTax": "10.00",
                        "orderNumber": "Order124"
                    },
                    "ip_address": "10.10.10.10"
                },
                "host_report": {
                    "status": "PASS",
                    "responseCode": "A0000",
                    "responseMessage": "Success",
                    "authCode": "594450",
                    "hostResponseCode": "00",
                    "hostReferenceNumber": "695565385087",
                    "taskID": "88208569",
                    "transactionID": "35265177",
                    "transactionTimestamp": "2025-04-02T19:15:20",
                    "transactionAmount": "110.00",
                    "processedAmount": "110.00",
                    "totalAmount": "110.00",
                    "addressVerificationCode": "X",
                    "cardHolderVerificationCode": "N",
                    "cardType": "visa",
                    "maskedCardNumber": "1111",
                    "customerReceipt": "        Sandbox US Merchant         \\n        200 Epcot Center Dr         \\n         Orlando, FL 32836          \\n            800-490-8514            \\n                 \\n                 \\n        2025-04-02 07:15 PM         \\n           CREDIT - SALE            \\n         Entry Mode : KEYED         \\n      Transaction ID: 35265177      \\n      Invoice Number: Order124      \\nDescription: Payment for the service\\n                 s                  \\n       SUBTOTAL: USD $100.00        \\n       SALES TAX: USD $10.00        \\n         TOTAL: USD $110.00         \\n                 \\n                 \\n       NO SIGNATURE REQUIRED        \\n              APPROVED              \\n                 \\n                 \\n                 \\n                 \\n                 \\n                 \\n                 \\n                 \\n                 \\n                 \\n           Customer Copy            \\n",
                    "merchantReceipt": "        Sandbox US Merchant         \\n        200 Epcot Center Dr         \\n         Orlando, FL 32836          \\n            800-490-8514            \\n                 \\n                 \\n        2025-04-02 07:15 PM         \\n           CREDIT - SALE            \\n         Entry Mode : KEYED         \\n      Transaction ID: 35265177      \\n      Invoice Number: Order124      \\nDescription: Payment for the service\\n                 s                  \\n       SUBTOTAL: USD $100.00        \\n       SALES TAX: USD $10.00        \\n         TOTAL: USD $110.00         \\n                 \\n                 \\n      X_______________________      \\nI AGREE TO PAY ABOVE TOTAL AMOUNT IN\\n ACCORDANCE WITH CARD ISSUER's AGREE\\nMENT (MERCHANT AGREEMENT IF CREDIT V\\n              OUCHER)               \\n     KEEP COPY FOR YOUR RECORDS     \\n               \\n \\n                \\n              APPROVED              \\n                 \\n                 \\n                 \\n                 \\n                 \\n                 \\n                 \\n                 \\n                 \\n                 \\n           Merchant Copy            \\n",
                    "partialPayment": false,
                    "providedSalesTax": true
                },
                "kount_score": null,
                "card_type": "visa",
                "last_4": "1111",
                "payment_method": "Credit Card",
                "status": "succeeded",
                "fee_amount": null,
                "net_amount": "110.00",
                "type": "payment",
                "is_offline": false,
                "updated_at": "2025-04-02T19:15:20.839Z",
                "created_at": "2025-04-02T19:15:20.839Z",
                "description": "Payment for the services",
                "auth_datetime": "2025-04-02T19:15:20.839Z",
                "capture_datetime": "2025-04-02T19:15:20.839Z",
                "internalTransactionID": "987654321",
                "batch_id": null,
                "refund_type": null,
                "fee_type": null,
                "presettlement_fee": null,
                "merchant_gateway_override_id": null,
                "metadata": null,
                "threeds_auth_data": null,
                "gateway": "sandbox",
                "gateway_id": null,
                "customer_name": "John Doe",
                "settled": false,
                 "device":{
                    "id":"a42627a7-1368-4f2d-b22e-f78f2d216d3e",
                    "type":"pax",
                    "name":"Shaun's Mobile",
                    "model":"S24",
                    "serial_number":"1234de30e5fcfcbb7819c18e264ce4000dd0",
                    "sdk_version":"1.0.0",
                    "manufacturer": "Pax",
                    "app_version": "1.0.0 (1)",
                    "os": "android",
                    "os_version": "14" 
                }
            }
        ],
        "partialAllowed": true
    }
}

{
    "data": {
        "id": "cfe6316d-2ecd-4812-9930-26c346589f58",
        "amount": "150.00",
        "is_offline": false,
        "standalone": false,
        "isOverridenTransaction": false,
        "originalBankAccountToken": "ba_sandbox_pjkaTwqPT9VbXAkW8PJRyIvD",
        "refundable": true,
        "voidable": false,
        "details": [
            {
                "id": "0057fe84-d2d1-4580-ac54-c968ec930a5e",
                "external_id": "48124179",
                "currency": "USD",
                "requested_currency": null,
                "amount": "150.00",
                "currency_conversion_rate": null,
                "requested_amount": null,
                "data": {
                    "last_4": "2169",
                    "bank_account_id": "979d4581-9b49-4429-aa20-334bcd440741",
                    "first_name": "test",
                    "last_name": "test",
                    "additional_data": {
                        "ach_additional_data": "id",
                        "ach_additional_data_test2": "email"
                    },
                    "order_number": "150t65898"
                },
                "host_report": {
                    "status": "PASS",
                    "responseCode": "A0000",
                    "responseMessage": "Success",
                    "hostReferenceNumber": "202091513801",
                    "taskID": "46153475",
                    "transactionID": "48124179",
                    "transactionTimestamp": "2025-04-02T19:25:03",
                    "transactionAmount": "150.00",
                    "processedAmount": "150.00",
                    "totalAmount": "150.00",
                    "customerReceipt": "        Sandbox US Merchant         \\n        200 Epcot Center Dr         \\n         Orlando, FL 32836          \\n            800-490-8514            \\n                 \\n                 \\n        2025-04-02 07:25 PM         \\n             ACH - SALE             \\n         Entry Mode : KEYED         \\n      Transaction ID: 48124179      \\n     Invoice Number: 150t65898      \\n       SUBTOTAL: USD $150.00        \\n         TOTAL: USD $150.00         \\n                 \\n                 \\n       NO SIGNATURE REQUIRED        \\n              APPROVED              \\n                 \\n                 \\n                 \\n                 \\n                 \\n                 \\n                 \\n                 \\n                 \\n                 \\n           Customer Copy            \\n",
                    "merchantReceipt": "        Sandbox US Merchant         \\n        200 Epcot Center Dr         \\n         Orlando, FL 32836          \\n            800-490-8514            \\n                 \\n                 \\n        2025-04-02 07:25 PM         \\n             ACH - SALE             \\n         Entry Mode : KEYED         \\n      Transaction ID: 48124179      \\n     Invoice Number: 150t65898      \\n       SUBTOTAL: USD $150.00        \\n         TOTAL: USD $150.00         \\n                 \\n                 \\n      X_______________________      \\nI AGREE TO PAY ABOVE TOTAL AMOUNT IN\\n ACCORDANCE WITH CARD ISSUER's AGREE\\nMENT (MERCHANT AGREEMENT IF CREDIT V\\n              OUCHER)               \\n     KEEP COPY FOR YOUR RECORDS     \\n               \\n \\n                \\n              APPROVED              \\n                 \\n                 \\n                 \\n                 \\n                 \\n                 \\n                 \\n                 \\n                 \\n                 \\n           Merchant Copy            \\n"
                },
                "kount_score": null,
                "card_type": null,
                "last_4": "2169",
                "payment_method": "ACH",
                "status": "succeeded",
                "fee_amount": null,
                "net_amount": "150.00",
                "type": "payment",
                "is_offline": false,
                "updated_at": "2025-04-02T19:25:03.185Z",
                "created_at": "2025-04-02T19:25:03.185Z",
                "description": "Description text is long and should not be short so we can test regular test cases",
                "auth_datetime": "2025-04-02T19:25:03.185Z",
                "capture_datetime": "2025-04-02T19:25:03.185Z",
                "internalTransactionID": "987654321",
                "batch_id": null,
                "refund_type": null,
                "fee_type": null,
                "presettlement_fee": null,
                "merchant_gateway_override_id": null,
                "metadata": {
                    "ach_metadata": "id",
                    "ach_metadata_test2": "email"
                },
                "threeds_auth_data": null,
                "gateway": "sandbox",
                "gateway_id": null,
                "customer_name": "Test Test",
                "settled": false
            }
        ],
        "partialAllowed": true
    }
}
```

PreviousList Transactions NextSecure Fields Overview

Last updated 26 days ago