Skip to content

DOC-931 Clarifying the ToRenew status #354

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: main
Choose a base branch
from
+1 −1
Open

DOC-931 Clarifying the ToRenew status #354

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
196b009
DOC-931 Clarifying the ToRenew status
ntombing Jul 18, 2025
6fbd71d
fixup! DOC-931 Clarifying the ToRenew status
ntombing Jul 24, 2025
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
2 changes: 1 addition & 1 deletion docs/topics/cards/physical/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -363,7 +363,7 @@ flowchart LR

| Card renewal status | Explanation |
|---|---|
| `ToRenew` | Status triggered automatically 10 weeks before the card's expiry date. After this status is triggered by the Swan API, you can't stop the renewal process.<br /><br />*If you or the cardholder doesn't want to renew a physical card, [cancel the card](./guide-cancel.mdx) **at least 11 weeks** before the expiry date.* |
| `ToRenew` | Status triggered automatically 10 weeks before the card's expiry date. After this status is triggered by the Swan API, the renewal process can't be stopped unless the card is `Canceled` or `Suspended` and not resumed **before** the 10-week expiration window.<br /><br />*To prevent the renewal, the cardholder must [cancel the card](./guide-cancel.mdx) **more than 8 weeks** before the expiry date. |
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is quite hard to follow and doesn't quite address the original Slack request of:

Is the statement in the documentation we have here correct (screenshot in red)? In my understanding, if the status of the card is ToRenew , and if the user cancels/suspends the card, the renewal process ends and the card is not renewed.

Try this?

Status is triggered automatically 10 weeks before the card's expiry date. Once triggered by the Swan API, the renewal process can't be stopped unless the card is Canceled or remains Suspended until after the 10-week expiration window. To prevent renewal, the cardholder must cancel the card more than 8 weeks before the expiry date, or ensure it remains suspended during the renewal period.

| `Renewed` | Status triggered automatically 8 weeks before the card's expiry date. No updates to the delivery address can be made after this status is triggered. |

### Suspended physical cards {#renew-suspended}
Expand Down