Skip to content

Add payload and assurance data parameters for click to pay #240

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
MikkelThingholm wants to merge 2 commits into
base: master
Choose a base branch
from
Open

Add payload and assurance data parameters for click to pay #240

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
106fd46
Add payload and assurance data parameters for click to pay payment me…
MikkelThingholm Jun 2, 2026
76c3063
Enhance Click to Pay documentation by adding details for two interfaces
MikkelThingholm Jun 4, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 30 additions & 2 deletions ...te/content/gateway/api_resources/authorizations/authorizations_methods/token.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,35 @@ Requirement of some parameters depends on the initiator of the transaction; a pa

Click to Pay token payment method for both Visa and Mastercard CITs.


Click to Pay can be used through two interfaces.
The first interface uses the payloads from the checkout response:

{{% description_list %}}
{{% description_term %}}clicktopay[payload] {{% regex %}}[\:json\:] {{% /regex %}} {{% /description_term %}}
{{% description_details %}} Full decrypted payload serialized as JSON, supplied as a string. The encrypted payload can be found in the `encryptedPayload` field in the Click to Pay checkout response.

Example: `{"token":{"paymentToken":"",...}, "dynamicData":[{...}],...}`
{{% /description_details %}}

{{% description_term %}}clicktopay[assurance_data] {{% regex %}}[\:json\:] {{% /regex %}} {{% /description_term %}}
{{% description_details %}} Full assurance data serialized as JSON, supplied as a string. The assurance data can be found in the `assuranceData` field in the Click to Pay checkout response.

Example: `{"verificationData":[{"verificationType":"", "verificationMethod":"", "methodResults":{...},...},...], "eci":"",...}`

{{% regex_optional %}}Required for all Visa transactions. For Mastercard, required only when 3‑D Secure authentication was performed `ONBEHALF` {{% /regex_optional %}}
{{% /description_details %}}

{{% description_term %}}clicktopay[3dsecure] {{% regex %}}dictionary{{% /regex %}}{{% /description_term %}}
{{% description_details %}}See [Authentication: [3dsecure]](#authentication-3dsecure-v2).
{{% regex_optional %}}Optional. Should be sent if 3D-Secure authentication was done separately{{% /regex_optional %}}
{{% /description_details %}}
{{% /description_list %}}

The second interface uses raw values:

{{% description_list %}}

{{% description_term %}}clicktopay[tan] {{% regex %}}[0-9]{12,19}{{% /regex %}}{{% /description_term %}}
{{% description_details %}}Token Account Number (TAN) of the token to charge.
{{% /description_details %}}
Expand Down Expand Up @@ -53,7 +81,7 @@ Click to Pay token payment method for both Visa and Mastercard CITs.

#### Method: token

Token payment method for both For both Visa Token Service (VTS) and Mastercard Digital Enablement Service (MDES)
Token payment method for both Visa Token Service (VTS) and Mastercard Digital Enablement Service (MDES)

The required values are found in:
- the VTS provision token response.
Expand Down Expand Up @@ -105,7 +133,7 @@ The required values are found in:


{{% description_term %}}token[tav] {{% regex %}}[:base64:]{28}{{% /regex %}}{{% /description_term %}}
{{% description_details %}}Token Authentication Value (TAV) also know as token cryptogram.
{{% description_details %}}Token Authentication Value (TAV) also known as token cryptogram.

Visa specific name: Token Authentication Verification Value (TAVV).

Expand Down