Skip to main content

Make a card disbursement

This operation allow you to apply a disburse to a card in order to allow increase it's available balance to make transactions (purchases, withdrawals or transferences) and decreases your main balance available.

HTTP Request

POST /cards/disbursement

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 that will receive the disbursement
amount 
required
floatdigitsThe amount to disburse
latitude 
required
floatDigits format "DD.ddddd" (5 decimal precision)Latitude from where the disbursement 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 disbursement 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",
"amount": 10000.00,
"latitude": 12.12345,
"longitude": 15.12345
}

Example JSON Response:

{
"success": true,
"code": 0,
"message": "OK",
"data": {
"operation": {
"id": "4158d533-e95a-4c05-a341-ef7d369d3a09",
"authorization_code": "542010",
"amount": 10000.00
},
"card": {
"id": "11111111-daa7-1234-aaaa-123123123ecd",
"masked_card_number": "************1234",
"type": "PHYSICAL",
"status": "ACTIVE"
},
"account": {
"id": "22222222-daa7-1234-aaaa-123123123ecd",
"reference": 555555555
}
}
}