List Card Arts

Returns the card arts available to the issuing account. The list combines the channel’s system-default card art and any card arts bound to the account or its master account.

Use this endpoint to populate a card-art picker before creating or updating a card.

GET /v1/issuing/cards/arts

List Card Arts

cURL

curl --request GET \
  --url https://api-sandbox.uqpaytech.com/api/v1/issuing/cards/arts \
  --header 'x-auth-token: <api-key>'

200

{
  "default_card_art_id": "01KD52BKQWDMFF63R1NNQN7A79",
  "card_arts": [
    {
      "card_art_id": "01KD52BKQWDMFF63R1NNQN7A79",
      "description": "Premium Black",
      "is_default": true,
      "is_system_config": false
    }
  ]
}

授权

x-auth-token · string · header · 必填

The API token for login provided by UQPay.

请求头

x-on-behalf-of · string

Specifies the sub-account on whose behalf the request is made. This should be set to the account_id, which can be retrieved via the List Connected Accounts endpoint. If omitted or empty, the request is executed using the master account. More information at Connected Accounts.

响应

200 - application/json

Card arts retrieved successfully.

default_card_art_id · string · 必填

The issuing account's current default card art. A Create Card call that omits card_art_id uses this value.

示例:

"01KD52BKQWDMFF63R1NNQN7A79"

card_arts · object[] · 必填

Card arts available to the issuing account, ordered with the default first, then system-configured arts, then account-bound arts.

Show child attributes