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
Header | Description |
---|---|
Authorization required | The Bearer token created in Get authorization Token |
Content-Type required | application/json |
Body parameters
Parameter | Type | Pattern | Description |
---|---|---|---|
card_number required | string | 16 digits* or uuid | The card_number or card_id to be activated. |
latitude required | float | Digits 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 | float | Digits 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"
}
}
}