Top up card
Last updated
Last updated
POST {{baseUrl}}/customer/virtual/cards/topup
This endpoint allows you to top up a virtual card with a specified amount for a customer.
These fees apply to both MasterCard and Visa Virtual USD cards.
Card Creation
$1 for every newly issued card
Top Up
$1 if funding is below $100 and 1% if funding is equal to or above $100
Chargeback
$60 flat rate for Visa Card
Termination
no fee is charged for the termination of cards, you get back the balance on the card
Cross Border Fees
2.5% + $0.5 per transaction settled outside the USA
Card Declined
$1 for automatic termination after 3 Insufficient funds Transactions
No specific headers are required for this endpoint, but typically, you might need to include authorization tokens or other headers as per your API's authentication requirements.
The request body must include the following fields:
customer_id: (string) The unique identifier of the customer.
cardId: (string) The unique identifier of the virtual card.
amount: (number) The amount to top up the virtual card.
The response will include the status of the request, a relevant message, and details about the top-up operation.
If the customer's wallet is empty and the top-up cannot be completed, the following error response will be returned:
Or if there is an error confirming the card's activation status, the following error response will be returned:
If the top-up request is successful and in progress, the following success response will be returned:
status: Indicates the failure status of the request (e.g., "failed").
status_code: HTTP status code of the response (e.g., 400 for client errors).
message: A message describing the result of the request (e.g., "Request failed").
data: Contains details about the error encountered.
error: A message indicating the specific error (e.g., "Wallet is empty" or "Error please confirm card is active, or contact support if error persist").
status: Indicates the success status of the request (e.g., "success").
status_code: HTTP status code of the response (e.g., 200 for success).
message: A message describing the result of the request (e.g., "Request successful").
data: Contains details about the top-up operation.
message: A message indicating that the card top-up is in progress.
By following the above details, you can successfully top up a virtual card for a customer.