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": "visa",
  "channel": "alip",
  "currency": "HKD",
  "balance": "10.00",
  "card_holder": {
    "email": "[email protected]",
    "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 HKD)	Decimal	required	"1.00"
currency	Amount currency (currently only support HKD)	string(32)	required	HKD
brand	visa (fixed this value)	required	required
channel	alip (fixed this value)	required	required
card_holder		object	required
- email		string	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": "100",
    "brand": "visa",
    "card_id": "VC108603007011120321",
    "card_issuance_status": "creating",
    "card_status": "initialized",
    "channel": "alip",
    "currency": "HKD",
    "fee": "0",
    "request_id": "C1"
  },
  "message": "ok",
  "rid": "b9017e11f6b349d98f8c2eace00463bb"
}

Step 2. Receive card detail webhook

Once the card is created, we will send the card information back to your webhook address. Examples of detailed card information are shown below.

{
  "notify_type": "card_create_success",
  "data": {
    "card_id": "VC108603007011120000",
    "request_id": "VC108603007011120000",
    "brand": "visa",
    "channel": "alip",
    "currency": "HKD",
    "balance": "100",
    "expire_year": "****",
    "expire_month": "**",
    "card_number": "****************",
    "cvv": "***"
  }
}