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.
cardSuffixstringNoRequested card number suffix; support is determined by card product configuration.
mobilestringNoRegistered mobile number; format requirements are determined by card product configuration.

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.