On This Page

Payment Details API

This section contains the information you need to retrieve the non-sensitive data associated with a Unified Checkout transient token and the payment details API. This API can be used to retrieve personally identifiable information, such as the cardholder name and billing and shipping details, without retrieving payment credentials, which helps ease the PCI compliance burden.

There are two methods of authentication, and they are described in the

Getting Started with REST Developer Guide

Set Up a JSON Web Token Message

Set Up HTTP Signature Message

IMPORTANT

Visa Acceptance Solutions recommends that you dynamically parse the response for the fields that you are looking for when you integrate with Visa Acceptance Solutions APIs. Visa Acceptance Solutions may add additional fields in the future.

You must ensure that your integration can handle new fields that are returned in the response. Even though the underlying data structures do not change, you must also ensure that your integration can handle changes to the order in which the data is returned. Visa Acceptance Solutions uses semantic versioning practices, which enables you to retain backwards compatibility as new fields are introduced in minor version updates.

Endpoint

Production:

GET https://api.visaacceptance.com/flex/v2/payment-details/{jti}

Test:

GET https://apitest.visaacceptance.com/flex/v2/payment-details/{jti}

The

{jti}

is the ID of the JWT within the transient token that is returned by Unified Checkout. The transient token is a JWT object that you retrieved as part of a successful capture of payment information from a cardholder.

Required Field for Retrieving Transient Token Payment Details

Your payment details request must include this field:

id: The
{id}
is the full JWT received from Unified Checkout as the result of capturing payment information.

REST Example: Retrieving Transient Token Payment Details

Request

GET https://apitest.visaacceptance.com/flex/v2/payment-details/{jti}

Response to Successful Request

{
  "paymentInformation": {
    "card": {
      "expirationYear": "2026",
      "number": "XXXXXXXXXXXX1111",
      "expirationMonth": "05",
      "type": "001"
    }
  },
  "orderInformation": {
    "amountDetails": {
      "totalAmount": "21.00",
      "currency": "USD"
    },
    "billTo": {
      "lastName": "Lee",
      "country": "US",
      "firstName": "Tanya",
      "email": "[email protected]"
    },
    "shipTo": {
      "locality": "Small Town",
      "country": "US",
      "administrativeArea": "CA",
      "address1": "123 Main Street",
      "postalCode": "98765"
    }
  }
}