Issue a Card
POST/openapi/v1/cards/issueCard| Item | Value |
|---|---|
| HTTP method | POST |
| Request path | /openapi/v1/cards/issueCard |
| Request type | application/json |
Request parameters:
| Field | Type | Required | Description |
|---|---|---|---|
requestNo | string | Yes | Caller-provided business idempotency key, 1 to 64 visible ASCII characters; spaces are not allowed. |
email | string | Yes | User email address. |
cardTypeId | string | Yes | Card type ID, up to 64 characters. |
embossedName | string | No | Name embossed on the card; required status and length are determined by card product configuration. |
cardSuffix | string | No | Requested card number suffix; support is determined by card product configuration. |
mobile | string | No | Registered mobile number; format requirements are determined by card product configuration. |
Response data
| Field | Type | Description |
|---|---|---|
cardOrderNo | string | Platform card issuance order number. |
requestNo | string | Caller-provided business idempotency key. |
email | string | User email address. |
memberId | string | Platform member ID. |
cardTypeId | string | Card type ID. |
currency | string | Card product currency, usually a three-letter ISO 4217 code; determined by product configuration. |
type | string | Card type; currently known values are PHYSICAL, VIRTUAL. Product configuration may introduce additional values. |
feeAmount | string | Card issuance fee amount, as a string without scientific notation. |
feeAssetCode | string | Card issuance fee asset. |
accepted | boolean | Whether the request has been accepted. |
status | string | Platform card issuance status: PROCESSING, SUCCESS, FAILED. |
failCode | string | Failure code. |
failMessage | string | Failure message. |
last4 | string | Last four digits of the card number. |
expiryMonth | string | Expiry month. |
expiryYear | string | Expiry year. |
createTime | string | Order creation time. |
completedTime | string | Time when the order reached its terminal state. |
