Skip to content

Commit 36fe763

Browse files
authored
Click to Pay proposal 1 (#211)
This approach follows the current way of adding a new token payment method via a `clicktopay[...]` parameter. <img width="702" height="833" alt="image" src="https://github.com/user-attachments/assets/f00a0d0e-9438-4f69-8a6e-f7a026798b4a" />
1 parent 297ddae commit 36fe763

File tree

2 files changed

+38
-1
lines changed
  • website/content/gateway/api_reference

2 files changed

+38
-1
lines changed

website/content/gateway/api_reference/changes/changes.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,10 @@ Follow coming changes on the [source code repository](https://github.com/clearha
1010

1111
Sorted by descending timestamp.
1212

13+
#### Add support for Click to Pay
14+
Starting 2025-10-01, we support Click to Pay as a token framework. Please see
15+
[Method: token](#method-token) for details.
16+
1317
#### Add minimum amount for Visa captures and refunds
1418
Starting 2025-05-19, we will enforce a minimum amount of USD 0.005 for captures
1519
and refunds made with Visa. This is due to USD 0.005 being half a minor, and

website/content/gateway/api_reference/resources/authorizations/authorizations_methods/token.md

Lines changed: 34 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,8 +6,9 @@ weight: 135
66
---
77
#### Method: token
88

9-
Two token frameworks are supported:
9+
Three token frameworks are supported:
1010

11+
* `clicktopay`: Click to Pay
1112
* `token[m4m]`: Mastercard Digital Enablement Service (MDES) for Merchants (M4M)
1213
* `token[vts]`: Visa Token Service (VTS)
1314

@@ -17,6 +18,38 @@ Requirement of some parameters depends on the initiator of the transaction; a pa
1718
**Notice**: Signing is required to use the `token` payment method.
1819
{{% /notice %}}
1920

21+
#### Method: Click to Pay
22+
23+
Click to Pay token payment method for both Visa and Mastercard CITs.
24+
25+
{{% description_list %}}
26+
{{% description_term %}}clicktopay[tan] {{% regex %}}[0-9]{12,19}{{% /regex %}}{{% /description_term %}}
27+
{{% description_details %}}Token Account Number (TAN) of the token to charge.
28+
{{% /description_details %}}
29+
30+
{{% description_term %}}clicktopay[expire_month] {{% regex %}}[0-9]{2}{{% /regex %}}{{% /description_term %}}
31+
{{% description_details %}}Expiry month of token to charge.
32+
{{% /description_details %}}
33+
34+
{{% description_term %}}clicktopay[expire_year] {{% regex %}}20[0-9]{2}{{% /regex %}}{{% /description_term %}}
35+
{{% description_details %}}Expiry year of token to charge.
36+
{{% /description_details %}}
37+
38+
{{% description_term %}}clicktopay[tav] {{% regex %}}[:base64:]{28}{{% /regex %}}{{% /description_term %}}
39+
{{% description_details %}}Token authentication value, also known as cryptogram.
40+
{{% /description_details %}}
41+
42+
{{% description_term %}}clicktopay[eci] {{% regex %}}0[57]{{% /regex %}}{{% /description_term %}}
43+
{{% description_details %}}Zero-padded e-commerce indicator from token flow.
44+
{{% regex_optional %}}Required for Visa CITs.{{% /regex_optional %}}
45+
{{% /description_details %}}
46+
47+
{{% description_term %}}clicktopay[3dsecure] {{% regex %}}dictionary{{% /regex %}}{{% /description_term %}}
48+
{{% description_details %}}See [Authentication: [3dsecure]](#authentication-3dsecure-v2).
49+
{{% regex_optional %}}Optional{{% /regex_optional %}}
50+
{{% /description_details %}}
51+
{{% /description_list %}}
52+
2053
#### Method: token[m4m]
2154

2255
The required values are found in either the MDES `transact` response or the Secure Card on File (SCOF) `checkout` response.

0 commit comments

Comments
 (0)