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 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 | |
| balance | Initial balance top up into this new card (minimum 1 USD) | Decimal | required | "1.00" |
| currency | Amount currency (currently only support USD) | string(32) | required | USD |
| brand | mastercard (fixed this value) | required | required | |
| channel | hsbc (fixed this value) | required | required | |
| card_holder | object | required | ||
| - first_name | string | required | ||
| - last_name | string | required | ||
| - country | string | required | ||
| - street | string | required | ||
| - city | string | required | ||
| - state | string | required | ||
| - zip_code | string | required |
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"
}