Make a card withdrawal

This operation allow you to apply a withdrawal from a card. This operation decrease the available balance in card and increases your collection balance account.

HTTP Request

POST /cards/withdrawal

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 that will receive the withdrawal.
amount  required	float	digits	The amount to withdraw
latitude  required	float	Digits format "DD.ddddd" (5 decimal precision)	Latitude from where the withdrawal 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 withdrawal is made. West longitudes are preceded by a minus sign. Longitudes range from -180 to 180
pin  optional	string	4 digits**	The PIN if you need cardholder validation

note

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

note

*pin 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,
    "pin": "t7wog3ytUb4pDQZT6AhE1USJab_-v7ut6AztPIH_SJK9gRETQQnFmqFPS-qcexyuRly0Hr9_jaG5YAnE_7CNNl_nbLYBi6YJvpnoZFSQdVgPaI0Pm07pl6SNPz3S0",
    "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
        },
        "card": {
            "id": "11111111-daa7-1234-aaaa-123123123ecd",
            "masked_card_number": "************1234",
            "type": "PHYSICAL",
            "status": "ACTIVE"  
        },
        "account": {
            "id": "22222222-daa7-1234-aaaa-123123123ecd",
            "reference": 555555555
        }
    }
}