Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
4 changes: 4 additions & 0 deletions website/content/gateway/api_reference/changes/changes.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,10 @@ Follow coming changes on the [source code repository](https://github.com/clearha

Sorted by descending timestamp.

#### Add support for Click to Pay
Starting 2025-10-01, we support Click to Pay as a token framework. Please see
[Method: token](#method-token) for details.

#### Add minimum amount for Visa captures and refunds
Starting 2025-05-19, we will enforce a minimum amount of USD 0.005 for captures
and refunds made with Visa. This is due to USD 0.005 being half a minor, and
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,9 @@ weight: 135
---
#### Method: token

Two token frameworks are supported:
Three token frameworks are supported:

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

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

#### Method: Click to Pay

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

{{% 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 %}}

{{% description_term %}}clicktopay[expire_month] {{% regex %}}[0-9]{2}{{% /regex %}}{{% /description_term %}}
{{% description_details %}}Expiry month of token to charge.
{{% /description_details %}}

{{% description_term %}}clicktopay[expire_year] {{% regex %}}20[0-9]{2}{{% /regex %}}{{% /description_term %}}
{{% description_details %}}Expiry year of token to charge.
{{% /description_details %}}

{{% description_term %}}clicktopay[tav] {{% regex %}}[:base64:]{28}{{% /regex %}}{{% /description_term %}}
{{% description_details %}}Token authentication value, also known as cryptogram.
{{% /description_details %}}

{{% description_term %}}clicktopay[eci] {{% regex %}}0[57]{{% /regex %}}{{% /description_term %}}
{{% description_details %}}Zero-padded e-commerce indicator from token flow.
{{% regex_optional %}}Required for Visa CITs.{{% /regex_optional %}}
{{% /description_details %}}

{{% description_term %}}clicktopay[3dsecure] {{% regex %}}dictionary{{% /regex %}}{{% /description_term %}}
{{% description_details %}}See [Authentication: [3dsecure]](#authentication-3dsecure-v2).
{{% regex_optional %}}Optional{{% /regex_optional %}}
{{% /description_details %}}
{{% /description_list %}}

#### Method: token[m4m]

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