> ## Documentation Index
> Fetch the complete documentation index at: https://developers.uqpay.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Set Default Card Art
> Personal Visa only
Sets the default card art for the issuing account. Subsequent [Create Card](/card-issuance/v1.6/api-reference/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](/card-issuance/v1.6/guide/card-art) for the full resolution order.
## OpenAPI
````yaml /card-issuance/v1.6/issuing.yaml post /v1/issuing/cards/arts/default
openapi: 3.0.2
info:
title: Issuing API
version: 0.0.1
description: >
UQPAY Issuing API allows you to issue virtual cards, manage cardholders, and
monitor card transactions.
## What you can do
- Create and manage virtual cards (issue, activate, freeze, cancel)
- Onboard and verify cardholders with KYC
- Set spending limits and card controls
- Recharge and withdraw card balances
- Query card transactions and account balances
- Transfer funds between issuing accounts
- Generate and download reports
## Authentication
All requests require a valid auth token obtained via the [Access
Token](/account-center/v1.6/api-reference/access-token) endpoint. Include
the token in the `x-auth-token` header.
## Idempotency
POST requests support the `x-idempotency-key` header to safely retry without
creating duplicate resources.
contact:
name: UQPAY Support Team
url: https://www.uqpay.com/support
email: support@uqpay.com
license:
name: Proprietary
url: https://www.uqpay.com/legal/api-terms
termsOfService: https://www.uqpay.com/legal/terms
x-api-id: uqpay-issuing-api-v1.6.0
x-categories:
- Card Issuing
- Transaction Processing
x-features:
- Virtual Card Issuance
- Real-time Processing
- Webhook Notifications
- Comprehensive Reporting
- Transaction Monitoring
servers:
- url: https://api-sandbox.uqpaytech.com/api
description: Sandbox base URL.
- url: https://api.uqpay.com/api
description: Production base URL.
security: []
tags:
- name: Card Lifecycle
description: >-
Create cards and manage their full lifecycle — issue, retrieve, update,
activate, assign, and change status.
- name: Card Secure Data
description: >-
Access sensitive card data (PAN, CVV) through the PCI-compliant endpoint
or a tokenized iframe. Availability depends on your PCI status, not the
card product.
- name: Card Funding
description: Load and unload a card's stored balance for prepaid-style cards.
- name: Card PIN
description: >-
Set and manage card PINs. `reset-pin` covers physical cards;
`manage-card-pin` covers virtual cards.
- name: Card Add-ons
description: >-
Product-specific card capabilities. Each operation applies only to certain
card products — see [Card
products](/card-issuance/v1.6/guide/card-products).
- name: Card Arts
description: >-
Manage the visual designs (card arts) available to your issuing account.
Set an account-wide default, or pass `card_art_id` when issuing or
updating a card to override per card. Available on Personal Visa.
- name: Cardholders
description: >-
You can create cardholders, which are authorized representatives of your
business that can be issued cards.
- name: Transactions
description: >-
These APIs allow you to retrieve information on transactions that are made
on your user's cards.
- name: Products
description: >-
With this set of APIs, you will be able to create card orders for your
customers.
- name: Balances
description: >-
The available and pending amounts for each currency are broken down
further by payment source types. You can retrieve it to see the balance
currently on your issuing account.
- name: Transfers
description: Transfer funds between issuing accounts.
- name: Reports
description: Generate and download issuing reports.
- name: Simulator
description: Simulate card transactions on the sandbox environment.
paths:
/v1/issuing/cards/arts/default:
post:
tags:
- Card Arts
summary: Set Default Card Art
description: >
Personal Visa only
Sets the default card art for the issuing account. Subsequent [Create
Card](/card-issuance/v1.6/api-reference/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](/card-issuance/v1.6/guide/card-art) for the full resolution order.
operationId: set-default-card-art
parameters:
- $ref: '#/components/parameters/XOnBehalfOf'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SetDefaultCardArtRequest'
responses:
'200':
headers:
x-response-id:
$ref: '#/components/headers/XResponseId'
description: Default card art updated successfully.
content:
application/json:
schema:
$ref: '#/components/schemas/SetDefaultCardArtResponse'
title: SetDefaultCardArtResponse
security:
- XAuthToken: []
components:
parameters:
XOnBehalfOf:
in: header
name: x-on-behalf-of
schema:
type: string
required: false
description: >
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](/account-center/v1.6/api-reference/list-connected-accounts)
endpoint. If omitted or empty, the request is executed using the master
account.
More information at [Connected
Accounts](/account-center/v1.6/guide/connected-accounts).
example: 18523f72-f4de-4f9c-bb8e-ec7d1c4f32be
schemas:
SetDefaultCardArtRequest:
type: object
required:
- card_art_id
properties:
card_art_id:
allOf:
- $ref: '#/components/schemas/CardArtId'
- description: >-
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](/card-issuance/v1.6/api-reference/list-card-arts)).
SetDefaultCardArtResponse:
type: object
required:
- default_card_art_id
- updated_at
properties:
default_card_art_id:
allOf:
- $ref: '#/components/schemas/CardArtId'
- description: The new default card art for the issuing account.
updated_at:
type: string
example: '2026-05-20 10:32:18'
description: Server time at which the default was updated.
CardArtId:
type: string
example: 01KD52BKQWDMFF63R1NNQN7A79
description: >-
Identifier of a card art. Stable across card products; reuse the same
value when creating multiple cards with the same design.
headers:
XResponseId:
description: >-
Universally unique identifier (UUID v4) for the response. Helpful for
identifying a request when communicating with UQPAY support.
schema:
type: string
format: uuid
example: 2adba88e-9d63-44bc-b975-9b6ae3440dde
securitySchemes:
XAuthToken:
type: apiKey
in: header
name: x-auth-token
description: The API token for login provided by UQPay.
````