Create a top-up request

When your card balance is exhausted, you can call the card top-up API to recharge your vcc card. Please note that when you top up a card, the card's expiration date and CVV may be updated, which is most likely to happen when the card is about to expire.

Step 0. Authentication

How to obtain access token Authentication Reference

Step 1. Initialize a Create Intent

POST /mch-api/v1/issuing/cards/update

• Example Request

{
  "request_id": "C6",
  "card_id": "VC95391650019020000",
  "action": "top_up",
  "amount": "1.00"
}

• Request

REQUEST BODY	Details	Type	Required	Example
request_id	The merchant unique ID created in merchant's order system that corresponds to this card.	string(32)	required
card_id	Please enter the card_id returned when creating the card	string	required
action	In this scenario, please fill in the fixed value "top_up"	string	required
amount	The amount you want to top up	decimal	required

You will get a response similar to the following.

{
  "code": "success",
  "data": {
    "balance": "2.00",
    "brand": "mastercard",
    "card_id": "VC95592697019020000",
    "card_issuance_status": "success",
    "card_number": "****************",
    "card_status": "active",
    "channel": "hsbc",
    "currency": "USD",
    "cvv": "***",
    "expiry_month": "08",
    "expiry_year": "2027",
    "request_id": "VC95592697019020000"
  },
  "message": "ok",
  "rid": "d9c784d768674b079ef7baaec69d7dbe"
}