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"
}