v1

latestOpenAPI 3.0.22026-07-26123510445.2 KB

Transactions

Claim Unsolicited Refund

<a href="/card-issuance/v1.6/guide/card-products" style={{display:'inline-block',padding:'2px 10px',borderRadius:'9999px',fontSize:'12px',fontWeight:600,lineHeight:'18px',background:'#EEF2FF',color:'#4338CA',border:'1px solid #C7D2FE',textDecoration:'none'}}>Business Visa only</a>

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.

post/v1/issuing/transactions/unsolicited_refund/release

Headers

x-on-behalf-ofstring

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 API. If omitted or empty, the request is executed using the master account. More information at Connected Accounts.

x-idempotency-keystring uuid

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.

Request body

related_transaction_idstring required

The original authorization's transaction identifier that the unsolicited refund is matched against. Use the authorization's transaction_id, not its short_reference_id.

remarkstring

Optional note describing the claim, stored with the request.

Example request

{
  "related_transaction_id": "c0cef051-29c5-4796-b86a-cd5b684bfad7",
  "remark": "claim unsolicited refund"
}

Response

OK - The claim was accepted for asynchronous processing.

request_status'SUCCESS'

Request status.