跳转到主要内容
GET
/
v1
/
issuing
/
transactions
/
{id}
Retrieve Cards Transaction
curl --request GET \
  --url https://api-sandbox.uqpaytech.com/api/v1/issuing/transactions/{id} \
  --header 'x-auth-token: <api-key>'
{
  "card_id": "c0cef051-29c5-4796-b86a-cd5b684bfad7",
  "card_number": "************5668",
  "cardholder_id": "7c4ff2cd-1bf6-4aaa-bf16-266771425011",
  "transaction_id": "5135e6cc-28b6-4889-81dc-3b86a09e1395",
  "short_transaction_id": "CT2024-03-01",
  "original_transaction_id": "1234e6cc-28b6-4889-81dc-3b86a09e1395",
  "transaction_type": "AUTHORIZATION",
  "transaction_fee": 0.25,
  "transaction_fee_currency": "SGD",
  "fee_pass_through": "Y",
  "card_available_balance": 2506.26,
  "authorization_code": 856268,
  "billing_amount": 70.25,
  "billing_currency": "SGD",
  "transaction_amount": 100.25,
  "transaction_currency": "USD",
  "transaction_time": "2024-03-21T17:17:32+08:00",
  "description": "1107 - Invalid CVV2",
  "transaction_status": "DECLINED",
  "posted_time": "2024-03-21T17:17:32+08:00",
  "merchant_data": {
    "category_code": "6011",
    "city": "CITY NAME",
    "country": "CN",
    "name": "ACQUIRER NAME"
  },
  "wallet_type": "ApplePay"
}

Documentation Index

Fetch the complete documentation index at: https://developers-sandbox.uqpaytech.com/llms.txt

Use this file to discover all available pages before exploring further.

授权

​
x-auth-token
string
header
必填

The API token for login provided by UQPay.

请求头

​
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.

路径参数

​
id
string
必填

Unique identifier for the cards transaction.

示例:

"c0cef051-29c5-4796-b86a-cd5b684bfad7"

响应

200 - application/json

OK - Card transaction returned successfully.

​
card_id
string
必填

Unique identifier for the card.

示例:

"c0cef051-29c5-4796-b86a-cd5b684bfad7"

​
card_number
string
必填

Masked card number

示例:

"************5668"

​
cardholder_id
string<uuid>
必填

The cardholder’s unique identifier.

示例:

"7c4ff2cd-1bf6-4aaa-bf16-266771425011"

​
transaction_id
string<uuid>
必填

Unique Identifier for transaction.

示例:

"5135e6cc-28b6-4889-81dc-3b86a09e1395"

​
short_transaction_id
string<uuid>
必填

Short unique identifier for transaction.

示例:

"CT2024-03-01"

​
original_transaction_id
string<uuid>
必填

Unique Identifier for the original transaction.

示例:

"1234e6cc-28b6-4889-81dc-3b86a09e1395"

​
transaction_type
enum<string>
必填

Transaction type of card.

可用选项:
AUTHORIZATION,
REFUND,
FUND COLLECTION,
ATM DEPOSIT,
REVERSAL,
VALIDATION,
SETTLEMENT DEBIT,
SETTLEMENT CREDIT,
SETTLEMENT REVERSAL,
CHARGEBACK DEBIT,
CHARGEBACK CREDIT
示例:

"AUTHORIZATION"

​
transaction_fee
number
必填

Transaction fee.

示例:

0.25

​
transaction_fee_currency
string
必填

Transaction fee currency.

示例:

"SGD"

​
fee_pass_through
enum<string>
必填

Indicates whether the transaction fee was deducted from the card balance.

  • Y – The transaction fee was charged directly from the card.
  • N – The transaction fee was covered by the main account instead of the card.
    By default, fees are charged to the main account unless configured otherwise.
可用选项:
Y,
N
示例:

"Y"

​
card_available_balance
number
必填

The card available balance.

示例:

2506.26

​
authorization_code
string
必填

Authorization Code

示例:

856268

​
billing_amount
number
必填

Billing amount

示例:

70.25

​
billing_currency
string
必填

Billing Currency

示例:

"SGD"

​
transaction_amount
number
必填

Transaction amount

示例:

100.25

​
transaction_currency
string
必填

Transaction currency

示例:

"USD"

​
transaction_time
string
必填

Transaction occurrence time

示例:

"2024-03-21T17:17:32+08:00"

​
description
string
必填

Provides additional context based on the transaction status.

  • If transaction_status is DECLINED, this field contains the reason for the failure.
  • If transaction_status is APPROVED, this field contains supplementary remarks(e.g. "1000 - Authorization Approval", "3DS Fee").
示例:

"1107 - Invalid CVV2"

​
transaction_status
enum<string>
必填

The high-level status indicating the stage of the transaction lifecycle.

可用选项:
APPROVED,
DECLINED,
PENDING
示例:

"DECLINED"

​
posted_time
string

Transaction posted time

示例:

"2024-03-21T17:17:32+08:00"

​
merchant_data
object

Details about the merchant (grocery store, e-commerce website, etc.) involved in this transaction.

​
wallet_type
enum<string>

Indicates which digital wallet was used for the transaction.

可用选项:
ApplePay,
GooglePay,
GOOGLE ECOMMERCE,
GOOGLE,
GOOGLE PAY
示例:

"ApplePay"