> ## 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.
# Claim Unsolicited Refund
> Business Visa only
Raise a claim to release an unsolicited refund that UQPAY intercepted, so it posts to the cardholder. An unsolicited refund is one the card network delivers without a matching original purchase. Use this when a merchant's refund against your original authorization has not arrived.
A `SUCCESS` response only means the claim was accepted for asynchronous processing; it does not mean the refund has posted.
## OpenAPI
````yaml /card-issuance/v1.6/issuing.yaml post /v1/issuing/transactions/unsolicited_refund/release
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/transactions/unsolicited_refund/release:
post:
tags:
- Transactions
summary: Claim Unsolicited Refund
description: >
Business Visa only
Raise a claim to release an unsolicited refund that UQPAY intercepted,
so it posts to the cardholder. An unsolicited refund is one the card
network delivers without a matching original purchase. Use this when a
merchant's refund against your original authorization has not arrived.
A `SUCCESS` response only means the claim was accepted for asynchronous
processing; it does not mean the refund has posted.
operationId: claim-unsolicited-refund
parameters:
- $ref: '#/components/parameters/XOnBehalfOf'
- $ref: '#/components/parameters/XIdempotencyKey'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- related_transaction_id
properties:
related_transaction_id:
type: string
description: >-
The original authorization's transaction identifier that the
unsolicited refund is matched against. Use the
authorization's `transaction_id`, not its
`short_reference_id`.
example: c0cef051-29c5-4796-b86a-cd5b684bfad7
remark:
type: string
description: Optional note describing the claim, stored with the request.
example: claim unsolicited refund
responses:
'200':
description: OK - The claim was accepted for asynchronous processing.
headers:
x-response-id:
$ref: '#/components/headers/XResponseId'
content:
application/json:
schema:
title: ClaimUnsolicitedRefundResponse
properties:
request_status:
$ref: '#/components/schemas/RequestStatus'
example:
request_status: SUCCESS
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
XIdempotencyKey:
in: header
name: x-idempotency-key
schema:
type: string
format: uuid
required: true
description: >-
A unique identifier (UUID) used to maintain operation idempotency,
ensuring that repeated executions of the same operation do not result in
unintended effects or duplication. It helps preserve data consistency in
the face of network errors, retries, or failures.
example: 18523f72-f4de-4f9c-bb8e-ec7d1c4f32be
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
schemas:
RequestStatus:
type: string
description: |
Request status.
enum:
- SUCCESS
securitySchemes:
XAuthToken:
type: apiKey
in: header
name: x-auth-token
description: The API token for login provided by UQPay.
````