From 26199b0483d7b0514f8c265381721f9f34482006 Mon Sep 17 00:00:00 2001 From: Will Pimblett Date: Tue, 25 Nov 2025 17:16:22 +0000 Subject: [PATCH 1/2] Add clarifying notes around using round number for TEMPLATE (and MULTIPLE) product orders --- features/merchant-selection-template.mdx | 1 + reference/2024-02-05/openapi.json | 2 +- 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/features/merchant-selection-template.mdx b/features/merchant-selection-template.mdx index 44933cf..74b20d5 100644 --- a/features/merchant-selection-template.mdx +++ b/features/merchant-selection-template.mdx @@ -35,6 +35,7 @@ Templates you create yourself cannot be used in the Playground environment. Inst - Set the `type` of the `products` object to `TEMPLATE` - Set the `template_id` in the `products` object to the ID you have obtained from the previous step. + - Ensure the `face_value` is a round number and equal or greater than the minimum face value of the products selected. ```json Request example {9-12} { diff --git a/reference/2024-02-05/openapi.json b/reference/2024-02-05/openapi.json index 3fa3124..e38187d 100644 --- a/reference/2024-02-05/openapi.json +++ b/reference/2024-02-05/openapi.json @@ -1249,7 +1249,7 @@ "properties": { "face_value": { "title": "Face Value", - "description": "Face value of the payout link. The currency of the face value is inferred from the product selection.", + "description": "Face value of the payout link. The currency of the face value is inferred from the product selection.\n\nWhat value is allowed depends on the product mode:\n- When ordering a `SINGLE` product this field follows the allowed values from the selected product.\n- If using `MULTIPLE` or `TEMPLATE` this value must be: equal or greater than the minimum face value of the products selected and be a round number.", "minimum": 0.01, "example": 10, "type": "number" From f7ebcd3eef5d1fefd3b1920a96bf854e1da79bea Mon Sep 17 00:00:00 2001 From: Will Pimblett Date: Tue, 25 Nov 2025 17:29:44 +0000 Subject: [PATCH 2/2] Apply suggestions from code review Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- features/merchant-selection-template.mdx | 2 +- reference/2024-02-05/openapi.json | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/features/merchant-selection-template.mdx b/features/merchant-selection-template.mdx index 74b20d5..66debd7 100644 --- a/features/merchant-selection-template.mdx +++ b/features/merchant-selection-template.mdx @@ -35,7 +35,7 @@ Templates you create yourself cannot be used in the Playground environment. Inst - Set the `type` of the `products` object to `TEMPLATE` - Set the `template_id` in the `products` object to the ID you have obtained from the previous step. - - Ensure the `face_value` is a round number and equal or greater than the minimum face value of the products selected. + - Ensure the `face_value` is a whole number and equal or greater than the minimum face value of the products selected. ```json Request example {9-12} { diff --git a/reference/2024-02-05/openapi.json b/reference/2024-02-05/openapi.json index e38187d..50b47d8 100644 --- a/reference/2024-02-05/openapi.json +++ b/reference/2024-02-05/openapi.json @@ -1249,7 +1249,7 @@ "properties": { "face_value": { "title": "Face Value", - "description": "Face value of the payout link. The currency of the face value is inferred from the product selection.\n\nWhat value is allowed depends on the product mode:\n- When ordering a `SINGLE` product this field follows the allowed values from the selected product.\n- If using `MULTIPLE` or `TEMPLATE` this value must be: equal or greater than the minimum face value of the products selected and be a round number.", + "description": "Face value of the payout link. The currency of the face value is inferred from the product selection.\n\nWhat value is allowed depends on the product mode:\n- When ordering a `SINGLE` product this field follows the allowed values from the selected product.\n- If using `MULTIPLE` or `TEMPLATE` this value must be: equal or greater than the minimum face value of the products selected and be a whole number.", "minimum": 0.01, "example": 10, "type": "number"