Skip to main content
POST
/
cards
/
simulate-decline
Simulate a decline transaction
curl --request POST \
  --url https://access.utgl.io/v1/cards/simulate-decline \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "cardAccountId": "c8e2752d-6bd7-4244-a9f6-580f5640eaeb",
  "cardId": "c8e2752d-6bd7-4244-a9f6-580f5640eaec",
  "amount": 100,
  "currency": "HKD"
}
'
{
  "cardTransactionId": "8188d920-2c17-4aba-aa24-6a25f8c12ddb"
}

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json
​
cardAccountId
string
required

The card account ID to decline

Example:

"c8e2752d-6bd7-4244-a9f6-580f5640eaeb"

​
cardId
string
required

The card ID to decline

Example:

"c8e2752d-6bd7-4244-a9f6-580f5640eaec"

​
amount
number
required

The amount to decline

Example:

100

​
currency
string
required

The currency to decline

Example:

"HKD"

Response

200 - application/json

Decline transaction submitted

​
cardTransactionId
string

The ID of the declined transaction

Example:

"8188d920-2c17-4aba-aa24-6a25f8c12ddb"