Skip to main content

Change card status

This operation allow you to change the card status. You can block/unblock a card to accept or deny transactions, report for a replacement or make preventive blocks for the card.

HTTP Request

PUT /cards/status

Header Parameters

HeaderDescription
Autorization 
required
The Bearer token created in
Get authorization Token
Content-Type
required
application/json

Body parameters

ParameterTypePatternDescription
card_number 
required
string16 digits* or uuidThe card_number or card_id to be updated.
status 
required
stringCatalogThe update status for the card. See allowed values in
Get Card Status Catalog
latitude 
required
floatDigits format "DD.ddddd" (5 decimal precision)Latitude from where the status update is made. South latitudes are preceded by a minus sign. Latitudes range from -90 to 90
longitude 
required
floatDigits format "DDD.ddddd" (5 decimal precision)Longitude from where the status update is made. West longitudes are preceded by a minus sign. Longitudes range from -180 to 180
note

*If card_number is sended as 16 digits, it must be sended ciphered and Base 64 Encoded. See Data encryption & encoding.

Example JSON Request:

{
"card_number": "11111111-daa7-1234-aaaa-123123123ecd",
"status": "TEMPORARY_INACTIVE",
"latitude": 12.12345,
"longitude": 15.12345
}

Example JSON Response:


{
"success": true,
"code": 0,
"message": "OK",
"data": {
"card": {
"id": "11111111-daa7-1234-aaaa-123123123ecd",
"masked_card_number": "************1234",
"type": "PHYSICAL",
"status": "TEMPORARY_INACTIVE"
},
"account": {
"id": "12312312-1234-1234-1234-123456123123",
"reference": "555555555"
}
}
}