Skip to main content

Make a payment to a card

This operation allow you to make a payment to a card. The payment is similar to Disburse, but allow you to specify a description for the payment. This operation increase your card's available balance and decreases your main balance available.

HTTP Request

POST /cards/payment

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 payment
amount 
required
floatdigitsThe amount to receive has pay
payment_description 
required
string1-32 charactersThe payment description
latitude 
required
floatDigits format "DD.ddddd" (5 decimal precision)Latitude from where the payment 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 payment 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": 1000.00,
"payment_description": "ABONO POR COMISIONES",
"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": 1000.00,
"payment_description": "ABONO POR COMISIONES"
},
"card": {
"id": "11111111-daa7-1234-aaaa-123123123ecd",
"masked_card_number": "************1234",
"type": "PHYSICAL",
"status": "ACTIVE"
},
"account": {
"id": "22222222-daa7-1234-aaaa-123123123ecd",
"reference": 555555555
}
}
}