Retrieve Cards Transaction

curl --request GET \
  --url https://api-sandbox.uqpaytech.com/api/v1/issuing/transactions/{id} \
  --header 'x-auth-token: <api-key>'

import requests

url = "https://api-sandbox.uqpaytech.com/api/v1/issuing/transactions/{id}"

headers = {"x-auth-token": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-auth-token': '<api-key>'}};

fetch('https://api-sandbox.uqpaytech.com/api/v1/issuing/transactions/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api-sandbox.uqpaytech.com/api/v1/issuing/transactions/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-auth-token: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api-sandbox.uqpaytech.com/api/v1/issuing/transactions/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-auth-token", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api-sandbox.uqpaytech.com/api/v1/issuing/transactions/{id}")
  .header("x-auth-token", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-sandbox.uqpaytech.com/api/v1/issuing/transactions/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-auth-token"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "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"
}

GET

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>'

import requests

url = "https://api-sandbox.uqpaytech.com/api/v1/issuing/transactions/{id}"

headers = {"x-auth-token": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-auth-token': '<api-key>'}};

fetch('https://api-sandbox.uqpaytech.com/api/v1/issuing/transactions/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api-sandbox.uqpaytech.com/api/v1/issuing/transactions/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-auth-token: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api-sandbox.uqpaytech.com/api/v1/issuing/transactions/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-auth-token", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api-sandbox.uqpaytech.com/api/v1/issuing/transactions/{id}")
  .header("x-auth-token", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-sandbox.uqpaytech.com/api/v1/issuing/transactions/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-auth-token"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "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"
}

授权

x-auth-token

string

header

必填

由 UQPay 提供的登录 API Token。

请求头

x-on-behalf-of

string

指定代表哪个子账户发起请求。应设置为 account_id，该值可通过 List Connected Accounts 接口获取。若省略或为空，则请求以主账户身份执行。更多信息参见关联账户。

路径参数

string

必填

卡片交易的唯一标识符。

示例:

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

响应

200 - application/json

成功返回卡片交易。

card_id

string

必填

卡片的唯一标识符。

示例:

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

card_number

string

必填

脱敏卡号

示例:

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

cardholder_id

string<uuid>

必填

持卡人的唯一标识符。

示例:

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

transaction_id

string<uuid>

必填

交易的唯一标识符。

示例:

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

short_transaction_id

string<uuid>

必填

交易的短唯一标识符。

示例:

"CT2024-03-01"

original_transaction_id

string<uuid>

必填

原始交易的唯一标识符。

示例:

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

transaction_type

enum<string>

必填

卡片交易类型。

AUTHORIZATION：因用卡而预留的资金。
REFUND：将消费金额退回账户余额。
FUND COLLECTION：由卡组织上报、入账到持卡人卡账户的入款。由网络触发（而非持卡人 API 调用）；与 CARD RECHARGE 不同。
ATM DEPOSIT：通过 ATM 存入账户的资金。
REVERSAL：对授权的冲正。
VALIDATION：绑卡验证。
SETTLEMENT DEBIT：对账差异的轧差与扣减。
SETTLEMENT CREDIT：对账差异的轧差与入账。
SETTLEMENT REVERSAL：对账差异的轧差与冲正。
CHARGEBACK DEBIT：因拒付而扣减的资金。
CHARGEBACK CREDIT：因拒付而入账的资金。

可用选项:

AUTHORIZATION,

REFUND,

FUND COLLECTION,

ATM DEPOSIT,

REVERSAL,

VALIDATION,

SETTLEMENT DEBIT,

SETTLEMENT CREDIT,

SETTLEMENT REVERSAL,

CHARGEBACK DEBIT,

CHARGEBACK CREDIT

示例:

"AUTHORIZATION"

transaction_fee

number

必填

交易手续费。

示例:

0.25

transaction_fee_currency

string

必填

交易手续费币种。

示例:

"SGD"

fee_pass_through

enum<string>

必填

表示本次交易是否带有转嫁的低额交易费（LOW_TRANSACTION_FEE）。

Y – 交易触发了低额交易费规则；transaction_fee / transaction_fee_currency 携带该转嫁费用。
N – 不适用此类转嫁费用（默认）。仅当交易金额（以 USD 计）落在卡片配置的低额交易费阈值区间内时触发。

可用选项:

Y,

N

示例:

"Y"

card_available_balance

number

必填

卡片可用余额。

示例:

2506.26

authorization_code

string

必填

授权码

示例:

856268

billing_amount

number

必填

账单金额

示例:

70.25

billing_currency

string

必填

账单币种

示例:

"SGD"

transaction_amount

number

必填

交易金额

示例:

100.25

transaction_currency

string

必填

交易币种

示例:

"USD"

transaction_time

string

必填

交易发生时间

示例:

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

description

string

必填

根据交易状态提供额外的上下文信息。

若 transaction_status 为 DECLINED，此字段包含失败原因。
若 transaction_status 为 APPROVED，此字段包含补充备注（如 "1000 - Authorization Approval"、"3DS Fee"）。

示例:

"1107 - Invalid CVV2"

transaction_status

enum<string>

必填

表示交易生命周期所处阶段的高层状态。

可用选项:

APPROVED,

DECLINED,

PENDING

示例:

"DECLINED"

posted_time

string

交易入账时间

示例:

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

merchant_data

object

本次交易涉及的商户详情（如杂货店、电商网站等）。

Show child attributes

wallet_type

enum<string>

表示本次交易使用了哪种数字钱包。

可用选项:

ApplePay,

GooglePay,

GOOGLE ECOMMERCE,

GOOGLE,

GOOGLE PAY

示例:

"ApplePay"

List cards transactions Claim unsolicited refund