Get Sandbox Keys
API Reference

Replace Card

post
https://v1/v1/cards/

Use this API to replace an existing card — for example, when a card has been damaged, lost, or stolen. A new physical card is issued to the cardholder while retaining the same card number and account details, ensuring continuity with no disruption to linked services.

Pass the cardIdForReplace as a path parameter to identify the card being replaced, set the command query parameter to REPLACE, and provide a replaceReason in the request body (e.g., DAMAGED or STOLEN).

Note: A successful API response indicates the replacement request was accepted. To confirm the card's actual updated status, subscribe to the webhook below.

Webhooks

EventWebhook Reference
Replace CardReplace Card
Path Params
integer
required
Defaults to 1

The unique identifier of the card to be replaced.
Example: 1

Query Params
string
required
Defaults to REPLACE

The action command for this request. For replace a card, this value must always be REPLACE.
Example: REPLACE

Body Params
string
enum
required
Defaults to DAMAGED

The replacement reason for the card.
Possible values: LOST, STOLEN, DAMAGED, CARD_NOT_RECEIVED
Example: DAMAGED

Allowed:
Headers
string
required

The ID of your banking instance visible in the MBANQ Console.

string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Updated 3 months ago

Did this page help you?
Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 3 months ago

Did this page help you?