Capture Context

The capture context request is a signed JSON Web Token (JWT) that includes all of the merchant-specific parameters. This request tells the frontend JavaScript library how to behave within your payment experience. The request provides authentication, one‑time keys, the target origin to the Unified Checkout Integration integration in addition to allowed card networks and payment types (card or check). The capture context request includes these elements:

Allowed card networks

Allowed payment types

Client version

Target origin

For information on JSON Web Tokens, see JSON Web Tokens.

Target Origin: The target origin is defined by the scheme (protocol), hostname (domain) and port number (if used).

You must use the https:// protocol. Sub‑domains must also be included in the target origin.

Any valid top‑level domain is supported such as .com, .co.uk, and.gov.br. Wildcards are not supported.

For example, if you are launching Unified Checkout Integration on example.com, the target origin could be any of the following:

https://example.com
https://subdomain.example.com
https://example.com:8080

You can define the payment cards and digital payments that you want to accept in the capture context.
Allowed Card Networks: Use the
allowedCardNetworks
field to define the card types.

These card networks are available for card entry:
American Express
Cartes Bancaires
Carnet
China UnionPay
Diners Club
Discover
EFTPOS
ELO
JCB
JCrew
Mada
Maestro
Mastercard
Meeza
Visa

To support dual-branded or co-badged cards, you must list your supported card types values for the
allowedCardNetworks
field based on your preference for processing card numbers. For example, if a card is dual-branded as Visa and Cartes Bancaires and Cartes Bancaires is listed first, the card type is set to Cartes Bancaires after the card number is entered in your Unified Checkout Integration card collection form. For information on dual-branded or co-badged cards, see Support for Dual-Branded Cards.; IMPORTANT

Click to Pay supports American Express, Mastercard, and Visa for saved cards. Visa and Mastercard tokenize payment credentials using network tokenization for all Click to Pay requests. Click to Pay uses Click to Pay Token Requester IDs (TRIDs) rather than the your existing TRIDs.

IMPORTANT

Unified Checkout Integration does not process transactions for cards that do not have a card verification number (CVN) and expiration date. Most China UnionPay debit and credit cards issued before 2016 do not have a CVN and expiration date. You must decide whether you will require the CVN.

Allowed Payment Types: Use the
allowedPaymentTypes
field to define the accepted digital payment methods:
APPLEPAY
CHECK
CLICKTOPAY
GOOGLEPAY
PANENTRY

IMPORTANT

You can accept Apple Pay, Google Pay and check digital payment methods in Unified Checkout Integration without requiring card payments. To accept Apple Pay, Google Pay, and check digital payment methods without requiring card payments,include these digital payment methods in the
allowedPaymentTypes
field and exclude
PANENTRY
.

Use the

targetOrigins

and the

allowedPaymentTypes

fields to define the target origin and the accepted digital payment methods in your capture context. For example:

{
  "targetOrigins" : [ "https://www.test.com" ],
  "clientVersion" : "0.23",
  "allowedCardNetworks" : [ "VISA", "MASTERCARD", "AMEX" ],
  "allowedPaymentTypes" : [ "PANENTRY", "CLICKTOPAY", "GOOGLEPAY" ],
  "country" : "US",
  "locale" : "en_US",
  "captureMandate" : {
    "billingType" : "FULL",
    "requestEmail" : true,
    "requestPhone" : true,
    "requestShipping" : true,
    "shipToCountries" : [ "US", "GB" ],
    "showAcceptedNetworkIcons" : true
  },
  "orderInformation" : {
    "amountDetails" : {
      "totalAmount" : "1.01",
      "currency" : "USD"
    },
  }
}

This diagram shows how elements of the capture context request appear in the card entry form.

Image of the capture context request code and how it appears in the
entry form elements. — Anatomy of a Manual Card Entry Form

For more information on requesting the capture context, see Capture Context API.

Capture Context

Figure: