Make a transfer between cards

This operations allow you to make a transfer C2C (Card to Card) between the BIN ecosystem cards.

HTTP Request

POST /cards/transfer

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
origin_card  required	string	16 digits* or uuid	The card_number or card_id to be requested.
destination_card  required	string	16 digits*	The card_number or card_id to be requested.
amount  required	float	digits	Amount to transfer between cards
latitude  required	float	Digits format "DD.ddddd" (5 decimal precision)	Latitude from where the transfer 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 transfer 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:

{
    "origin_card": "11111111-daa7-1234-aaaa-123123123ecd",
    "destination_card": "v7ut6AztPIH_SJK9gRETQQnFmqFPS-qcexyuRly0Hr9_jaG5YAnE_7CNNl_nbLYBi6YJvpnoZFSQdVgPaSEPPbPEhyR_y3zTup6ZTQto0FXE1ArtLPmntQ6-RKg",
    "amount": 1000,
    "latitude": 12.12345,
    "longitude": 15.12345
}

Example JSON Response:

{
    "success": true,
    "code": 0,
    "message": "OK",
    "data": {
        "operation": { 
            "id": "a5030ec4-1f66-445d-b4d2-e3cf3a055fc1",
            "authorization_code": 65498745,
            "amount": 1000
        },
        "origin_card": {
            "id": "11111111-daa7-1234-aaaa-123123123ecd",
            "account_id": "22222222-daa7-1234-aaaa-123123123ecd",
            "type": "PHYSICAL",
            "card_number": "************1234",
            "account_reference": 555555555,
            "previous_balance": 3000,
            "new_balance": 2000
        },
        "destination_card": {
            "id": "33333333-daa7-1234-aaaa-123123123ecd",
            "account_id": "44444444-daa7-1234-aaaa-123123123ecd",
            "card_number": "************4321",
            "previous_balance": 1000,
            "new_balance": 2000
        }
    }
}