Reissue a Card
Replace a lost, stolen, damaged or expiring card with a new card on the same format, rail and wallet.
Before You Start
Read the following guides before proceeding:
| Guide | Why |
|---|---|
| Getting Started | Platform overview and setup |
| Api Basics | Required headers and request configuration |
| Authentication | How to obtain access tokens |
| Issue and Manage a Card | Card statuses, allowed_actions, fees and delivery addresses |
Overview
In active testing. Card reissue is under active testing, and the endpoint will be updated. Expect changes
to its request, response and behavior before it is final.
Reissue replaces an existing card with a new one — a new card with its own id, on the same format,
rail, funding wallet, chain and payment system. Use it instead of closing the card and ordering a new one.
The endpoint is v3 only and replaces any card whose allowed_actions lists Reissue, whichever version
issued it.
When a Card Can Be Reissued
| Condition | Rule |
|---|---|
| Status | NotActivated, Active, or Blocked by the user. A card blocked by Wirex cannot be reissued — contact Wirex support |
| Card age | At least 6 months since the card was created; 6 minutes in sandbox |
A card that is too young is refused with ErrorNotYetValid; error_details carries reissuable_from.
Reissue a Card
If the reissue is priced for the user, first create a fee invoice for the card's format, exactly as for a
new order, and keep its delivery_id:
POST /api/v2/cards/{type}/fees/{country}/payment
See Order Fees & Delivery. If the fee lookup answers
"You have no card order/delivery fees to pay", skip it and omit delivery_id.
Then reissue:
POST /api/v3/cards/{cardId}/reissue
Path parameters:
| Parameter | Description |
|---|---|
{cardId} | The id of the card to replace, from Get Cards. Must be a UUID |
Request body (physical card):
{
"reason": "Damaged",
"delivery_id": 12345,
"delivery_provider": "DHL",
"delivery_address": {
"line1": "10 Downing Street",
"line2": "Flat 2",
"city": "London",
"zip_code": "SW1A 2AA",
"country": "GB"
}
}Request body (virtual card):
{
"reason": "LostOrStolen",
"delivery_id": 12345
}| Field | Type | Required | Description |
|---|---|---|---|
reason | string | Yes | Expiration, Damaged, LostOrStolen or UpdateProduct — see Reissue Reasons |
delivery_address | object | Conditional | Required for a plastic or metal card, refused for a virtual one. See Delivery Address Fields |
delivery_provider | string | Conditional | Plastic and metal only. Required when fees are enforced for your company; otherwise defaults to DHL |
delivery_id | integer | No | From the fee invoice, for a priced reissue. The API does not refuse a reissue without it |
card_program | string | No | Card program for the replacement, from Card Order Configuration. Omitted, the old card's program is kept |
Response:
{
"id": "8c1f4b2e-3d5a-4f6b-9c7d-0e1f2a3b4c5d"
}| Field | Description |
|---|---|
id | The replacement card's id |
const res = await fetch(`${baseUrl}/api/v3/cards/${cardId}/reissue`, {
method: 'POST',
headers: {
'Authorization': `Bearer ${accessToken}`,
'X-User-Wallet': userEoaAddress,
'X-Chain-Id': chainId,
'Content-Type': 'application/json'
},
body: JSON.stringify({
reason: 'Damaged',
delivery_id: deliveryId, // omit when not priced
delivery_provider: 'DHL', // physical cards only
delivery_address: { line1: '10 Downing Street', city: 'London', zip_code: 'SW1A 2AA', country: 'GB' } // physical cards only
})
});
const { id: replacementId } = await res.json();res = requests.post(
f"{base_url}/api/v3/cards/{card_id}/reissue",
headers={
"Authorization": f"Bearer {access_token}",
"X-User-Wallet": user_eoa_address,
"X-Chain-Id": chain_id,
"Content-Type": "application/json"
},
json={
"reason": "Damaged",
"delivery_id": delivery_id, # omit when not priced
"delivery_provider": "DHL", # physical cards only
"delivery_address": {"line1": "10 Downing Street", "city": "London", "zip_code": "SW1A 2AA", "country": "GB"}, # physical cards only
},
)
replacement_id = res.json()["id"]body, _ := json.Marshal(map[string]interface{}{
"reason": "Damaged",
"delivery_id": deliveryId, // omit when not priced
"delivery_provider": "DHL", // physical cards only
"delivery_address": map[string]string{"line1": "10 Downing Street", "city": "London", "zip_code": "SW1A 2AA", "country": "GB"}, // physical cards only
})
req, _ := http.NewRequest("POST", baseURL+"/api/v3/cards/"+cardId+"/reissue", bytes.NewBuffer(body))
req.Header.Set("Authorization", "Bearer "+accessToken)
req.Header.Set("X-User-Wallet", userEoaAddress)
req.Header.Set("X-Chain-Id", chainId)
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
var replacement struct{ Id string `json:"id"` }
json.NewDecoder(resp.Body).Decode(&replacement)A virtual replacement is Active immediately. A plastic or metal replacement is NotActivated and ships to
delivery_address; the user activates it on arrival.
Reissue Reasons
| Reason | Use when |
|---|---|
Expiration | The card is approaching its expiry date |
Damaged | The physical card is damaged or worn |
LostOrStolen | The card is lost, stolen or compromised |
UpdateProduct | Move the card to a different card_program |
What Happens to the Old Card
| Old card | Becomes Closed |
|---|---|
| Virtual, any reason | When the replacement is issued |
Plastic or metal, Damaged | When the user activates the replacement |
Plastic or metal, LostOrStolen | Not automatically |
Reissue does not block the old card. For a lost or stolen card,
block it first withPUT /api/v1/cards/{cardId}/block— a card the
user blocked can still be reissued.
Webhooks
A reissue produces Card Status Webhooks for the replacement
and, when it closes, for the old card. Nothing in the payload links the two — keep the mapping from the
reissue response.
Error Handling
All 400 under CategoryValidationFailure:
| Error Reason | Description | Error Details | Resolution |
|---|---|---|---|
ErrorMissingField | Request failed validation | reason: Reason is required | Send a listed reason |
ErrorGeneral | Request failed validation | reason: Reason must be one of Expiration, Damaged, LostOrStolen, UpdateProduct | Send a listed reason |
ErrorNotYetValid | Card can be reissued 6 months after it was created (6 minutes in sandbox) | reissuable_from | Retry at reissuable_from |
ErrorInvalidStatus | Card status does not allow reissue | — | Requested and Closed cards cannot be reissued |
ErrorInvalidStatus | Card status was set by system, contact support to reissue | — | Contact Wirex support |
ErrorMissingField | Request failed validation | delivery_address: Delivery address is required on the reissue of a physical card | Send delivery_address |
ErrorMissingField | Request failed validation | delivery_provider: Delivery provider is required | Fees are enforced for your company: send delivery_provider |
ErrorGeneral | Request failed validation | delivery_address: Delivery is not accepted on the reissue of a virtual card | Omit delivery_address and delivery_provider |
ErrorNotFound | Card not found | — | Use a card of the user in X-User-Wallet |
ErrorGeneral | Request failed due to external validation failure | — | The card issuer refused the reissue, e.g. an unknown card_program |
Updated 15 days ago

