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:

GuideWhy
Getting StartedPlatform overview and setup
Api BasicsRequired headers and request configuration
AuthenticationHow to obtain access tokens
Issue and Manage a CardCard 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

ConditionRule
StatusNotActivated, Active, or Blocked by the user. A card blocked by Wirex cannot be reissued — contact Wirex support
Card ageAt 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:

ParameterDescription
{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
}
FieldTypeRequiredDescription
reasonstringYesExpiration, Damaged, LostOrStolen or UpdateProduct — see Reissue Reasons
delivery_addressobjectConditionalRequired for a plastic or metal card, refused for a virtual one. See Delivery Address Fields
delivery_providerstringConditionalPlastic and metal only. Required when fees are enforced for your company; otherwise defaults to DHL
delivery_idintegerNoFrom the fee invoice, for a priced reissue. The API does not refuse a reissue without it
card_programstringNoCard program for the replacement, from Card Order Configuration. Omitted, the old card's program is kept

Response:

{
  "id": "8c1f4b2e-3d5a-4f6b-9c7d-0e1f2a3b4c5d"
}
FieldDescription
idThe 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

ReasonUse when
ExpirationThe card is approaching its expiry date
DamagedThe physical card is damaged or worn
LostOrStolenThe card is lost, stolen or compromised
UpdateProductMove the card to a different card_program

What Happens to the Old Card

Old cardBecomes Closed
Virtual, any reasonWhen the replacement is issued
Plastic or metal, DamagedWhen the user activates the replacement
Plastic or metal, LostOrStolenNot automatically

Reissue does not block the old card. For a lost or stolen card,
block it first with PUT /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 ReasonDescriptionError DetailsResolution
ErrorMissingFieldRequest failed validationreason: Reason is requiredSend a listed reason
ErrorGeneralRequest failed validationreason: Reason must be one of Expiration, Damaged, LostOrStolen, UpdateProductSend a listed reason
ErrorNotYetValidCard can be reissued 6 months after it was created (6 minutes in sandbox)reissuable_fromRetry at reissuable_from
ErrorInvalidStatusCard status does not allow reissue—Requested and Closed cards cannot be reissued
ErrorInvalidStatusCard status was set by system, contact support to reissue—Contact Wirex support
ErrorMissingFieldRequest failed validationdelivery_address: Delivery address is required on the reissue of a physical cardSend delivery_address
ErrorMissingFieldRequest failed validationdelivery_provider: Delivery provider is requiredFees are enforced for your company: send delivery_provider
ErrorGeneralRequest failed validationdelivery_address: Delivery is not accepted on the reissue of a virtual cardOmit delivery_address and delivery_provider
ErrorNotFoundCard not found—Use a card of the user in X-User-Wallet
ErrorGeneralRequest failed due to external validation failure—The card issuer refused the reissue, e.g. an unknown card_program

Did this page help you?