Modular APIs - Sequence Diagrams

For a simplified integration, view the sequence diagrams for our orchestration Payments API.

One-off payment

Card payment using Card Payments API only.

Using:

  1. Card Payments API
BrowserMerchant_FrontendMerchant_BackendCard_Payments_APIClick PayPaycustomerInitiatedTransactions requestcustomerInitiatedTransactions responseSettlement requestSettlement responseBrowserMerchant_FrontendMerchant_BackendCard_Payments_API

Checkout

Card payment via the Checkout SDK, including the creation of a verified token.

Using:

  1. Checkout SDK
  2. Verified Token
  3. Card Payments API
BrowserMerchant_FrontendMerchant_BackendCheckout_SessionsVerified_Token_APICard_Payments_APICheckout JS added to pageIncludes SessionIncludes TokenClick PayCreate sessionReturn sessionPayVerified Token requestVerified Token responsecustomerInitiatedTransactions requestcustomerInitiatedTransactions responseSettlement requestSettlement responseBrowserMerchant_FrontendMerchant_BackendCheckout_SessionsVerified_Token_APICard_Payments_API

Payment with stored card

Creating a token, authentication using 3DS and using the token as part of a card payment.

For use with future Customer Initiated Payments (CIT)

Using:

  1. Tokens API
  2. 3DS API
  3. Card Payments API
BrowserMerchant_FrontendMerchant_BackendCard_Payments_APITokens_API3DS_APIIssuersIncludes TokenIncludes TokenUpdate or close challenge window on websiteApply authentication details in payment E.g. eci, authenticationValue etcIncludes TokenClick PayPaytokens requesttokens responsedeviceDataInitialization requestdeviceDataInitialization responseDeviceData - BIN/JWT/URL3DS Device Data formForm postPostMessage: dfReferenceIdauthentication requestauthentication responseChallenge JWT/URL3DS challenge formForm post`returnUrl` specified in authentication requestverification requestverification responsecustomerInitiatedTransactions requestcustomerInitiatedTransactions responseSettlement requestSettlement responseBrowserMerchant_FrontendMerchant_BackendCard_Payments_APITokens_API3DS_APIIssuers

Recurring Payments

Request 3DS authentication with the challenge set as mandated for SCA compliance. Send a card payments customer initiated transaction (CIT) request.

Using:

  1. 3DS API
  2. Card Payments API
BrowserMerchant_FrontendMerchant_Backend3DS_APICard_Payments_APIIssuersSet `challenge.preference.challengeMandated`Update or close challenge window on websiteApply authentication details in payment E.g. eci, authenticationValue etcSet `customerAgreement.type.subscription` `customerAgreement.storedCardUsage.first`Click PayPaydeviceDataInitialization requestdeviceDataInitialization responseDeviceData - BIN/JWT/URL3DS Device Data formForm postPostMessage: dfReferenceIdauthentication requestauthentication responseChallenge JWT/URL3DS challenge formForm post`returnUrl` specified in authentication requestverification requestverification responsecustomerInitiatedTransactions requestcustomerInitiatedTransactions responseSettlement requestSettlement responseBrowserMerchant_FrontendMerchant_Backend3DS_APICard_Payments_APIIssuers