Skip to main content

Activate a card

This operation allow you to activate a card. Every card in stock is created in a "Non Active status" (NEED_ACTIVATION), and you need to activate each card explicity.

note

This is a one time operation per card. A NEED_ACTVATION card can be disbursed or payed, but you can't make purchases, withdrawals or PIN updates.

HTTP Request

POST /cards/activate

Header Parameters

HeaderDescription
Authorization 
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 activated.
latitude 
required
floatDigits format "DD.ddddd" (5 decimal precision)Latitude from where the activation 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 activation 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",
"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": "ACTIVE"
},
"account": {
"id": "12312312-1234-1234-1234-123456123123",
"reference": "555555555"
}
}
}