Set Default Card Art

Sets the default card art for the issuing account. Subsequent Create Card requests that omit card_art_id will use this card art.

Passing the channel’s system-default card art clears any explicit default; the account then falls back to the system default. See Card art for the full resolution order.

POST /v1/issuing/cards/arts/default

Set Default Card Art

cURL

curl --request POST \
  --url https://api-sandbox.uqpaytech.com/api/v1/issuing/cards/arts/default \
  --header 'Content-Type: application/json' \
  --header 'x-auth-token: <api-key>' \
  --data '
{
  "card_art_id": "01KD52BKQWDMFF63R1NNQN7A79"
}
'

200

{
  "default_card_art_id": "01KD52BKQWDMFF63R1NNQN7A79",
  "updated_at": "2026-05-20 10:32:18"
}

Authorizations

x-auth-token · string · header · required

The API token for login provided by UQPay.

Headers

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.

Body

application/json

card_art_id · string · required

The card art to set as the issuing account's new default. Must be a card art available to the account (returned by List card arts).

Example:

"01KD52BKQWDMFF63R1NNQN7A79"

Response

200 - application/json

Default card art updated successfully.

default_card_art_id · string · required

The new default card art for the issuing account.

Example:

"01KD52BKQWDMFF63R1NNQN7A79"

updated_at · string · required

Server time at which the default was updated.

Example:

"2026-05-20 10:32:18"