Skip to content

Issue a Card ​

POST /openapi/v1/cards/issueCard
ItemValue
HTTP methodPOST
Request path/openapi/v1/cards/issueCard
Request typeapplication/json

Request parameters:

FieldTypeRequiredDescription
requestNostringYesCaller-provided business idempotency key, 1 to 64 visible ASCII characters; spaces are not allowed.
emailstringYesUser email address.
cardTypeIdstringYesCard type ID, up to 64 characters.
embossedNamestringNoName embossed on the card; required status and length are determined by card product configuration.
cardSuffixstringNoOptional requested card suffix; support depends on the card product.
mobilestringNoRegistered mobile number; format requirements are determined by card product configuration.

Request example:

json
{
  "requestNo": "ISSUE_20261021_001",
  "email": "user@example.com",
  "cardTypeId": "CARD_TYPE_ID",
  "cardSuffix": "7788"
}

Response data ​

FieldTypeDescription
cardOrderNostringPlatform card issuance order number.
requestNostringCaller-provided business idempotency key.
emailstringUser email address.
memberIdstringPlatform member ID.
cardTypeIdstringCard type ID.
currencystringCard product currency, usually a three-letter ISO 4217 code; determined by product configuration.
typestringCard type; currently known values are PHYSICAL, VIRTUAL. Product configuration may introduce additional values.
feeAmountstringCard issuance fee amount, as a string without scientific notation.
feeAssetCodestringCard issuance fee asset.
acceptedbooleanWhether the request has been accepted.
statusstringPlatform card issuance status: PROCESSING, SUCCESS, FAILED.
failCodestringFailure code.
failMessagestringFailure message.
last4stringLast four digits of the card number.
expiryMonthstringExpiry month.
expiryYearstringExpiry year.
createTimestringOrder creation time.
completedTimestringTime when the order reached its terminal state.