Assign virtual card balance

There are two types of virtual cards: Permanent and One-Time-Use. If the card is One-Time-Use you only can add balance once.

TO create a virtual card, you can use the following endpoint:

POST https://[base_url]/v1/virtual-cards/balance

Body parameters

PARAMETER	TYPE	REQ.	DESCRIPTION
virtual_card_id	String	Yes	Virtual card ID you want to assign the balance. You can get it from the Create Card response
balance	Integer	Yes	Desired balance you want for the card. Must be in cents

Body example

{
    "virtual_card_id": "car_02xrxXYrV7K0",
    "balance": 12340000
}

Endpoint response

Status code: 200

{
    "msg": "Saldo asignado correctamente a la tarjeta",
    "data": {
        "added_balance": 1000000000,
        "total_balance": 2000000000,
        "currency": "COP"
    }
}

Status code: 400, 401, 403, 404

{
 "code": "Status code",
 "message":"Error description",
 "detail": "Error details"
}