From e5697a3f03967dccd7e9e8508be117c200fb379b Mon Sep 17 00:00:00 2001 From: Christian Bobach Date: Tue, 16 Sep 2025 11:28:30 +0200 Subject: [PATCH 1/4] Update requirements from Visa to domestic credits and debits --- website/content/gateway/api_reference/changes/changes.md | 6 ++++++ .../gateway/api_reference/resources/credits/credits.md | 2 +- .../api_reference/resources/debits/sender_information.md | 8 ++++---- 3 files changed, 11 insertions(+), 5 deletions(-) diff --git a/website/content/gateway/api_reference/changes/changes.md b/website/content/gateway/api_reference/changes/changes.md index a3998ea4..339b74e7 100644 --- a/website/content/gateway/api_reference/changes/changes.md +++ b/website/content/gateway/api_reference/changes/changes.md @@ -10,6 +10,12 @@ Follow coming changes on the [source code repository](https://github.com/clearha Sorted by descending timestamp. +#### Visa will start requiring additinal fields for domestic credits and debits +Starting 2025-10-17, Visa will require `sender[name]`, `sender[address]`, `sender[city]`, +`sender[country]` for all `/credits` and `/debits`. +From 2026-04, Visa will also require `recipient[name]` for `/debits` and `card[name]` for +`/credits`. + #### 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 diff --git a/website/content/gateway/api_reference/resources/credits/credits.md b/website/content/gateway/api_reference/resources/credits/credits.md index c6c308d2..fd0f7563 100644 --- a/website/content/gateway/api_reference/resources/credits/credits.md +++ b/website/content/gateway/api_reference/resources/credits/credits.md @@ -51,7 +51,7 @@ POST https://gateway.clearhaus.com/credits {{% description_term %}}card[name] {{% regex %}}[A-Za-z0-9 ]{1,30}{{% /regex %}}{{% /description_term %}} {{% description_details %}}Name on card. -{{% regex_optional %}}Required for Mastercard Payment of Winnings (PoW) and for Mastercard cross-border non-PoW.{{% /regex_optional %}} +{{% regex_optional %}}Required for Visa. Required for Mastercard Payment of Winnings (PoW) and for Mastercard cross-border non-PoW.{{% /regex_optional %}} {{% /description_details %}} {{% /description_list %}} diff --git a/website/content/gateway/api_reference/resources/debits/sender_information.md b/website/content/gateway/api_reference/resources/debits/sender_information.md index 02890df9..814c92b6 100644 --- a/website/content/gateway/api_reference/resources/debits/sender_information.md +++ b/website/content/gateway/api_reference/resources/debits/sender_information.md @@ -17,17 +17,17 @@ Intra-EEA, mentioned below, includes the United Kingdom and Gibraltar. Example: "Doe Jane A." (last name, first name, optional middle initial). {{% regex_optional %}}It must not contain special characters (?, @, #, $, &, \*, etc.), be all numeric, be fictious, be a nickname or be incomplete (only first or last name).{{% /regex_optional %}} -{{% regex_optional %}}Required for intra-EEA and international debits. Also required if any of the address-related parameters are supplied.{{% /regex_optional %}} +{{% regex_optional %}}Required for Visa. Required for intra-EEA and international Mastercard debits. Also required if any of the address-related parameters are supplied.{{% /regex_optional %}} {{% /description_details %}} {{% description_term %}}sender[address] {{% regex %}}[\x20-\x7E]{1,35} [ASCII printable characters](https://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters){{% /regex %}}{{% /description_term %}} {{% description_details %}}The sender's address (street name, house number, etc.). -{{% regex_optional %}}Required for intra-EEA and international debits.{{% /regex_optional %}} +{{% regex_optional %}}Required for Visa. Required for intra-EEA and international Mastercard debits.{{% /regex_optional %}} {{% /description_details %}} {{% description_term %}}sender[city] {{% regex %}}[\x20-\x7E]{1,25} [ASCII printable characters](https://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters){{% /regex %}}{{% /description_term %}} {{% description_details %}}The sender's city. -{{% regex_optional %}}Required for intra-EEA and international debits.{{% /regex_optional %}} +{{% regex_optional %}}Required for Visa. Required for intra-EEA and international Mastercard debits.{{% /regex_optional %}} {{% /description_details %}} {{% description_term %}}sender[state] {{% regex %}}[A-Z]{2}{{% /regex %}}{{% /description_term %}} @@ -37,7 +37,7 @@ Example: "Doe Jane A." (last name, first name, optional middle initial). {{% description_term %}}sender[country] {{% regex %}}[A-Z]{2}{{% /regex %}}{{% /description_term %}} {{% description_details %}}The sender's country (ISO 3166-1 2-letter country code). -{{% regex_optional %}}Required for intra-EEA and international debits.{{% /regex_optional %}} +{{% regex_optional %}}Required for Visa. Required for intra-EEA and international Mastercard debits.{{% /regex_optional %}} {{% /description_details %}} {{% description_term %}}sender[date_of_birth] {{% regex %}}[0-9]{4}-[0-9]{2}-[0-9]{2} (YYYY-MM-DD){{% /regex %}}{{% /description_term %}} From 58d5d7994673a350b03488a3d6203d4f80368d16 Mon Sep 17 00:00:00 2001 From: Christian Bobach Date: Thu, 18 Sep 2025 21:27:55 +0200 Subject: [PATCH 2/4] Revert changes to sender_information.md --- .../api_reference/resources/debits/sender_information.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/website/content/gateway/api_reference/resources/debits/sender_information.md b/website/content/gateway/api_reference/resources/debits/sender_information.md index 814c92b6..02890df9 100644 --- a/website/content/gateway/api_reference/resources/debits/sender_information.md +++ b/website/content/gateway/api_reference/resources/debits/sender_information.md @@ -17,17 +17,17 @@ Intra-EEA, mentioned below, includes the United Kingdom and Gibraltar. Example: "Doe Jane A." (last name, first name, optional middle initial). {{% regex_optional %}}It must not contain special characters (?, @, #, $, &, \*, etc.), be all numeric, be fictious, be a nickname or be incomplete (only first or last name).{{% /regex_optional %}} -{{% regex_optional %}}Required for Visa. Required for intra-EEA and international Mastercard debits. Also required if any of the address-related parameters are supplied.{{% /regex_optional %}} +{{% regex_optional %}}Required for intra-EEA and international debits. Also required if any of the address-related parameters are supplied.{{% /regex_optional %}} {{% /description_details %}} {{% description_term %}}sender[address] {{% regex %}}[\x20-\x7E]{1,35} [ASCII printable characters](https://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters){{% /regex %}}{{% /description_term %}} {{% description_details %}}The sender's address (street name, house number, etc.). -{{% regex_optional %}}Required for Visa. Required for intra-EEA and international Mastercard debits.{{% /regex_optional %}} +{{% regex_optional %}}Required for intra-EEA and international debits.{{% /regex_optional %}} {{% /description_details %}} {{% description_term %}}sender[city] {{% regex %}}[\x20-\x7E]{1,25} [ASCII printable characters](https://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters){{% /regex %}}{{% /description_term %}} {{% description_details %}}The sender's city. -{{% regex_optional %}}Required for Visa. Required for intra-EEA and international Mastercard debits.{{% /regex_optional %}} +{{% regex_optional %}}Required for intra-EEA and international debits.{{% /regex_optional %}} {{% /description_details %}} {{% description_term %}}sender[state] {{% regex %}}[A-Z]{2}{{% /regex %}}{{% /description_term %}} @@ -37,7 +37,7 @@ Example: "Doe Jane A." (last name, first name, optional middle initial). {{% description_term %}}sender[country] {{% regex %}}[A-Z]{2}{{% /regex %}}{{% /description_term %}} {{% description_details %}}The sender's country (ISO 3166-1 2-letter country code). -{{% regex_optional %}}Required for Visa. Required for intra-EEA and international Mastercard debits.{{% /regex_optional %}} +{{% regex_optional %}}Required for intra-EEA and international debits.{{% /regex_optional %}} {{% /description_details %}} {{% description_term %}}sender[date_of_birth] {{% regex %}}[0-9]{4}-[0-9]{2}-[0-9]{2} (YYYY-MM-DD){{% /regex %}}{{% /description_term %}} From 70a98d5ce9c00df056c37cc0f9586c4fe648dd0e Mon Sep 17 00:00:00 2001 From: Christian Bobach Date: Thu, 18 Sep 2025 21:28:30 +0200 Subject: [PATCH 3/4] Update changes to reflect clarification to affected parameters --- website/content/gateway/api_reference/changes/changes.md | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/website/content/gateway/api_reference/changes/changes.md b/website/content/gateway/api_reference/changes/changes.md index 339b74e7..e6d2df47 100644 --- a/website/content/gateway/api_reference/changes/changes.md +++ b/website/content/gateway/api_reference/changes/changes.md @@ -11,10 +11,7 @@ Follow coming changes on the [source code repository](https://github.com/clearha Sorted by descending timestamp. #### Visa will start requiring additinal fields for domestic credits and debits -Starting 2025-10-17, Visa will require `sender[name]`, `sender[address]`, `sender[city]`, -`sender[country]` for all `/credits` and `/debits`. -From 2026-04, Visa will also require `recipient[name]` for `/debits` and `card[name]` for -`/credits`. +From 2026-04-XX, Visa will require `card[name]` for `/credits`. #### Add minimum amount for Visa captures and refunds Starting 2025-05-19, we will enforce a minimum amount of USD 0.005 for captures From 9134056e76a8a0060b171c5e14c9ba20fd93cd19 Mon Sep 17 00:00:00 2001 From: Christian Bobach Date: Mon, 29 Sep 2025 11:05:19 +0200 Subject: [PATCH 4/4] Update website/content/gateway/api_reference/changes/changes.md Co-authored-by: Jesper Kjeldgaard --- website/content/gateway/api_reference/changes/changes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/content/gateway/api_reference/changes/changes.md b/website/content/gateway/api_reference/changes/changes.md index e6d2df47..79c756ff 100644 --- a/website/content/gateway/api_reference/changes/changes.md +++ b/website/content/gateway/api_reference/changes/changes.md @@ -10,7 +10,7 @@ Follow coming changes on the [source code repository](https://github.com/clearha Sorted by descending timestamp. -#### Visa will start requiring additinal fields for domestic credits and debits +#### Visa will start requiring additional fields for domestic credits and debits From 2026-04-XX, Visa will require `card[name]` for `/credits`. #### Add minimum amount for Visa captures and refunds