Skip to main content

Create a virtual prepaid card

The card object is the actual resource associated with the card issued out by Aiscpay. It holds details such as linked account.

Step 0. Authentication​

How to obtain access token Authentication Reference

Step 1. Initialize a Create Intent​

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

  • Example Request
{
"request_id": "C1",
"brand": "mastercard",
"channel": "hsbc",
"currency": "USD",
"balance": "10.00",
"card_holder": {
"first_name": "Donald",
"last_name": "Trump",
"country": "US",
"street": "123 Main St",
"city": "San Francisco",
"state": "CA",
"zip_code": "94105"
}
}
  • Request
REQUEST BODYDetailsTypeRequiredExample
request_idThe merchant unique ID created in merchant's order system that corresponds to this card.string(32)required
balanceInitial balance top up into this new card (minimum 1 USD)Decimalrequired"1.00"
currencyAmount currency (currently only support USD)string(32)requiredUSD
brandmastercard (fixed this value)requiredrequired
channelhsbc (fixed this value)requiredrequired
card_holderobjectrequired
- first_namestringrequired
- last_namestringrequired
- countrystringrequired
- streetstringrequired
- citystringrequired
- statestringrequired
- zip_codestringrequired

You will get a response similar to the following.

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