Skip to main content

Update status

Request

ENDPOINT
/prepaid/card/CARD_KEY
METHOD
PATCH

Path params

FieldTypeDescriptionCharacters
CARD_KEY *stringCard identification key.uuid
Request Body
{
"status": "blocked"
}

Body params

CampoTipoDescriçãoCaracteres
status *stringCard Status.Enumerators

Enumerators card_status

EnumeratorsTranslationType
createdRequested createdInitial
buildingUnder constructionInitial
activeReady to tradeActive
embossingIn productionTemporary block
blockedBlockedTemporary block
warningWith suspicionTemporary block
pendingPendingTemporary block
lostLostTerminated
robbedRobbedTerminated
fraudFraudTerminated
canceledCanceledTerminated
theftTheftTerminated

Erros

STATUS
4XX
Response Body
{
"title": "Not Acceptable",
"description": "The operation is not valid for the current status of the card [canceled]",
"translation": "Unable to transition",
"code": "CARD000014"
}
CodeStatus codeDescription
QIT000001400Invalid Json schema.
CARD000011404It was not possible to fetch the Card for the card_key {card_key}.
CARD000013406Unable to transition from {old_status} to {new_status}.
CARD000014406The operation is not valid for the current status of the card [{card_status}].
CARD000015400We're sorry, but the card could not be update. Please try again later

Webhook

WEBHOOK_TYPE
baas.prepaid_card.card
Webhook Body
{
"webhook_type": "baas.prepaid_card.card",
"event_datetime": "2023-07-25T12:00:00.000Z",
"data": {
"card_key": "9bd93e97-bb6d-410f-8981-06b2765f12a1",
"type": "virtual",
"status": "active",
"old_status": "created"
}
}