Replace a card

post https://api-sandbox.modulrfinance.com/api-sandbox-token/cards/{id}/replace

Replace a card, with a reason STOLEN, DAMAGED, LOST, RENEW.

time	status	user agent
Retrieving recent requests…

Loading…

Path Params

string

required

The ID of the card

Body Params

reason

string

required

The reason for replacing the card. Can be one of DAMAGED (physical only), LOST, STOLEN, RENEW

externalRef

string

length between 1 and 50

Client reference for the newly created card. Maximum of 50 alphanumeric characters (including underscore, hyphen and space).

design

object

Design references for physical card and packaging

expiry

string

ISO 8601 date with year & month components only. The supplied value must be in the future (cannot be the current month) and is inclusive of the specified month. If no expiry is selected, the standard product expiry date will be set

shippingAddress

object

Shipping address details for card. Optional for individual customers whose partner has verification type EXTERNAL

Responses

Language

Credentials

Header


xxxxxxxxxx
1
curl --request POST \
2
     --url https://api-sandbox.modulrfinance.com/api-sandbox-token/cards//replace \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json' \
5
     --data '{"reason":"STOLEN"}'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

*/*

201Card replaced successfully

400Invalid request