Track transactions using an acquirer reference number

The acquirer reference number (ARN) is a unique value assigned to a credit or debit card transaction after the card has been processed. The ARN tracks the transaction's movement, which helps card brands, card issuing banks, and processors locate the transaction and confirm its handling.

Customers can use the ARN to confirm that a refund was processed. If you provide your customer with the ARN, their bank can trace the transaction using this value. The ARN is passed as part of the response object.

Without an ARN, if a customer's card has been lost, stolen, or closed since the original transaction, the issuing bank can have trouble routing a refund to the customer's account. When this happens, the bank reroutes the money to the appropriate account, mails the customer a check, or returns the money to your merchant account.

Know before you code

This integration requires an Expanded Checkout integration.

Availability

This integration is available:

Retrieve an ARN

You can retrieve the ARN for orders, captured payments, or refunded transactions. Make a GET call to the v2/checkout/orders/ORDER-ID, v2/payments/captures/CAPTURE-ID, or v2/payments/refunds/REFUND-ID endpoints to retrieve a transaction's ARN. If the ARN is available, it is listed in the response.

Orders API

API endpoint used: Show order details

"request": {
"method": "GET",
"path": "v2/checkout/orders/ORDER-ID?fields=payment_source",
"headers": {
  "Authorization: Bearer ACCESS-TOKEN"
}
},

Step result

A successful request results in the following:

Refund API

API endpoint used: Show refund details

"request": {
"method": "GET",
"path": "v2/payments/refunds/REFUND-ID",
"headers": {
  "Authorization: Bearer ACCESS-TOKEN"
}
},

Step result

A successful request results in the following:

Capture API

API endpoint used: Show captured payment details

"request": {
"method": "GET",
"path": "v2/payments/captures/CAPTURE-ID",
"headers": {
  "Authorization: Bearer ACCESS-TOKEN"
}
},

Step result

A successful request results in the following: