From 408ae1fd5fd64cb60675ac0614b12472e5881285 Mon Sep 17 00:00:00 2001 From: Will Pimblett Date: Thu, 30 Apr 2026 15:35:47 +0100 Subject: [PATCH] Clarify link vs product expiry --- features/redemption-api.mdx | 3 ++- reference/2024-02-05/openapi.json | 4 ++-- 2 files changed, 4 insertions(+), 3 deletions(-) diff --git a/features/redemption-api.mdx b/features/redemption-api.mdx index 2c61737..4912870 100644 --- a/features/redemption-api.mdx +++ b/features/redemption-api.mdx @@ -77,7 +77,8 @@ GET {payout.url}?format=json Expiry date of the gift card, if applicable. `3000-01-01` indicates the gift - card is valid indefinitely. + card is valid indefinitely. This reflects the product's own expiry policy and + is separate from the payout link expiry returned by the order endpoints. diff --git a/reference/2024-02-05/openapi.json b/reference/2024-02-05/openapi.json index d6fe730..aa8ac37 100644 --- a/reference/2024-02-05/openapi.json +++ b/reference/2024-02-05/openapi.json @@ -1671,7 +1671,7 @@ }, "PayoutStatus": { "title": "Payout status", - "description": "Current status of the payout link. An `ACTIVE` link is live but has not been claimed yet, it will change to `CLAIMED` once that has happened. If you request a cancellation the status will reflect this as `CANCELLED`. Finally if your account is configured with expiry, when a link expires it will be marked as `EXPIRED`.", + "description": "Current status of the payout link. An `ACTIVE` link is live but has not been claimed yet, it will change to `CLAIMED` once that has happened. If you request a cancellation the status will reflect this as `CANCELLED`. Finally, if your account is configured with link expiry, when the link itself expires it will be marked as `EXPIRED` — this is independent of the underlying product's own expiry policy.", "enum": ["ACTIVE", "CLAIMED", "CANCELLED", "EXPIRED"] }, "PayoutDetails": { @@ -1694,7 +1694,7 @@ }, "expiry_date": { "title": "Expiry Date", - "description": "The date that the payout link expires.", + "description": "When the payout link expires. This is the expiry of the payout link itself, not the underlying gift card or product.\n\nIf your account does not have expiry of links enabled this field will be set to `null`, the link does not expire.", "type": "string", "format": "date-time" }