List Issuing Balances Transactions
curl --request GET \
--url https://api-sandbox.uqpaytech.com/api/v1/issuing/balances/transactions \
--header 'x-auth-token: <api-key>'import requests
url = "https://api-sandbox.uqpaytech.com/api/v1/issuing/balances/transactions"
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/balances/transactions', 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/balances/transactions",
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/balances/transactions"
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/balances/transactions")
.header("x-auth-token", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-sandbox.uqpaytech.com/api/v1/issuing/balances/transactions")
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{
"total_items": 197,
"total_pages": 20,
"data": [
{
"transaction_id": "34695c4b-e06b-4bea-8d31-c8860d37a744",
"short_transaction_id": "T260909-2PD70R2OP728",
"account_id": "b1b89684-c2c4-4d54-b8a8-3572727fd120",
"balance_id": "fb095d8e-eaa1-4014-9410-a291928e301a",
"reference_id": "c3dbfba4-c9db-47fd-8d6f-4d2e58eb535f",
"transaction_type": "FEE",
"currency": "USD",
"amount": "1.5",
"ending_balance": "11452.88",
"description": "Reason: *0884 transaction decline, fee",
"create_time": "2026-09-09 16:07:06",
"complete_time": "2026-09-09 16:07:06",
"transaction_status": "COMPLETED"
},
{
"transaction_id": "187a5676-f7ee-4386-b3fd-174d2b23364e",
"short_transaction_id": "T260909-2PD70P4Z17NK",
"account_id": "b1b89684-c2c4-4d54-b8a8-3572727fd120",
"balance_id": "fb095d8e-eaa1-4014-9410-a291928e301a",
"reference_id": "d3fb10e2-0f7b-4fe8-986c-5abbb2d51ea4",
"transaction_type": "FEE",
"currency": "USD",
"amount": "1.5",
"ending_balance": "11454.38",
"description": "Reason: transaction approved fee",
"create_time": "2026-09-09 16:07:06",
"complete_time": "2026-09-09 16:07:06",
"transaction_status": "COMPLETED"
},
{
"transaction_id": "3488b4c5-86db-471c-857c-c5ce6d0e1220",
"short_transaction_id": "T260909-2PD70I0LGE0W",
"account_id": "b1b89684-c2c4-4d54-b8a8-3572727fd120",
"balance_id": "fb095d8e-eaa1-4014-9410-a291928e301a",
"reference_id": "b53491cf-0c36-4ab3-9771-07ee7d89117e",
"transaction_type": "FEE",
"currency": "USD",
"amount": "1.5",
"ending_balance": "11455.88",
"description": "Reason: transaction approved fee",
"create_time": "2026-09-09 16:07:03",
"complete_time": "2026-09-09 16:07:03",
"transaction_status": "COMPLETED"
},
{
"transaction_id": "87e56169-9d75-46cd-abac-bec2d67e27d6",
"short_transaction_id": "T260909-2PD70QCBRRPC",
"account_id": "b1b89684-c2c4-4d54-b8a8-3572727fd120",
"balance_id": "fb095d8e-eaa1-4014-9410-a291928e301a",
"reference_id": "72691771-811a-45f5-9e38-586a8e9d8e44",
"transaction_type": "ISSUING_REVERSAL",
"currency": "USD",
"amount": "0.1",
"ending_balance": "11457.38",
"description": "Card reversal approve transaction",
"create_time": "2026-09-09 16:07:03",
"complete_time": "2026-09-09 16:07:03",
"transaction_status": "COMPLETED"
},
{
"transaction_id": "5715a626-6f85-4aeb-a15b-d2dcec62fed9",
"short_transaction_id": "T260909-2PD70P4Z17NK",
"account_id": "b1b89684-c2c4-4d54-b8a8-3572727fd120",
"balance_id": "fb095d8e-eaa1-4014-9410-a291928e301a",
"reference_id": "d3fb10e2-0f7b-4fe8-986c-5abbb2d51ea4",
"transaction_type": "ISSUING_AUTHORIZATION",
"currency": "USD",
"amount": "0.1",
"ending_balance": "11457.28",
"description": "Card authorization approval transaction",
"create_time": "2026-09-09 16:07:03",
"complete_time": "2026-09-09 16:07:03",
"transaction_status": "COMPLETED"
},
{
"transaction_id": "a77b6c6b-636b-4e91-9744-66223e35abc7",
"short_transaction_id": "T260909-2PD70FNREJ9C",
"account_id": "b1b89684-c2c4-4d54-b8a8-3572727fd120",
"balance_id": "fb095d8e-eaa1-4014-9410-a291928e301a",
"reference_id": "4aaef847-5f90-4e86-9691-ffd8a8ec96d4",
"transaction_type": "FEE",
"currency": "USD",
"amount": "1.5",
"ending_balance": "11457.38",
"description": "Reason: transaction approved fee",
"create_time": "2026-09-09 16:07:02",
"complete_time": "2026-09-09 16:07:02",
"transaction_status": "COMPLETED"
},
{
"transaction_id": "d68bcf49-29c0-4431-98e2-f75a035bdeeb",
"short_transaction_id": "T260909-2PD70N0QMRR4",
"account_id": "b1b89684-c2c4-4d54-b8a8-3572727fd120",
"balance_id": "fb095d8e-eaa1-4014-9410-a291928e301a",
"reference_id": "b8defc70-bca1-43d9-8814-0388ca7b371e",
"transaction_type": "ISSUING_REFUND",
"currency": "USD",
"amount": "0.1",
"ending_balance": "11458.88",
"description": "Card refund approve transaction",
"create_time": "2026-09-09 16:07:02",
"complete_time": "2026-09-09 16:07:02",
"transaction_status": "COMPLETED"
},
{
"transaction_id": "62b9a8a6-416b-4884-95a7-da0053c17950",
"short_transaction_id": "T260909-2PD70KEQYBCW",
"account_id": "b1b89684-c2c4-4d54-b8a8-3572727fd120",
"balance_id": "fb095d8e-eaa1-4014-9410-a291928e301a",
"reference_id": "bcac3668-03b5-48a9-9d49-ac90de9a3dcd",
"transaction_type": "ISSUING_REFUND",
"currency": "USD",
"amount": "0.01",
"ending_balance": "11458.78",
"description": "Card refund approve transaction",
"create_time": "2026-09-09 16:07:00",
"complete_time": "2026-09-09 16:07:00",
"transaction_status": "COMPLETED"
},
{
"transaction_id": "6f413b66-e196-458d-90af-c71374a4c262",
"short_transaction_id": "T260909-2PD70JPPGYKG",
"account_id": "b1b89684-c2c4-4d54-b8a8-3572727fd120",
"balance_id": "fb095d8e-eaa1-4014-9410-a291928e301a",
"reference_id": "7a759eb5-e9b0-4cab-8d8a-7abdd51ba524",
"transaction_type": "ISSUING_AUTHORIZATION",
"currency": "USD",
"amount": "0.01",
"ending_balance": "11458.77",
"description": "Card authorization approval transaction",
"create_time": "2026-09-09 16:06:59",
"complete_time": "2026-09-09 16:06:59",
"transaction_status": "COMPLETED"
},
{
"transaction_id": "bf3c7543-7bf2-4dd9-95ac-152fa0ff62d1",
"short_transaction_id": "T260909-2PD70I0LGE0W",
"account_id": "b1b89684-c2c4-4d54-b8a8-3572727fd120",
"balance_id": "fb095d8e-eaa1-4014-9410-a291928e301a",
"reference_id": "b53491cf-0c36-4ab3-9771-07ee7d89117e",
"transaction_type": "ISSUING_AUTHORIZATION",
"currency": "USD",
"amount": "0.1",
"ending_balance": "11458.78",
"description": "Card authorization approval transaction",
"create_time": "2026-09-09 16:06:59",
"complete_time": "2026-09-09 16:06:59",
"transaction_status": "COMPLETED"
}
]
}Balances
List Issuing Balances Transactions
查询发卡账户余额的变动记录，用于对账。结果分页返回，可按时间、币种、交易类型、状态或交易 ID 筛选。若需查询卡片交易，请使用 List Cards Transactions。
GET
/
v1
/
issuing
/
balances
/
transactions
List Issuing Balances Transactions
curl --request GET \
--url https://api-sandbox.uqpaytech.com/api/v1/issuing/balances/transactions \
--header 'x-auth-token: <api-key>'import requests
url = "https://api-sandbox.uqpaytech.com/api/v1/issuing/balances/transactions"
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/balances/transactions', 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/balances/transactions",
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/balances/transactions"
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/balances/transactions")
.header("x-auth-token", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-sandbox.uqpaytech.com/api/v1/issuing/balances/transactions")
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{
"total_items": 197,
"total_pages": 20,
"data": [
{
"transaction_id": "34695c4b-e06b-4bea-8d31-c8860d37a744",
"short_transaction_id": "T260909-2PD70R2OP728",
"account_id": "b1b89684-c2c4-4d54-b8a8-3572727fd120",
"balance_id": "fb095d8e-eaa1-4014-9410-a291928e301a",
"reference_id": "c3dbfba4-c9db-47fd-8d6f-4d2e58eb535f",
"transaction_type": "FEE",
"currency": "USD",
"amount": "1.5",
"ending_balance": "11452.88",
"description": "Reason: *0884 transaction decline, fee",
"create_time": "2026-09-09 16:07:06",
"complete_time": "2026-09-09 16:07:06",
"transaction_status": "COMPLETED"
},
{
"transaction_id": "187a5676-f7ee-4386-b3fd-174d2b23364e",
"short_transaction_id": "T260909-2PD70P4Z17NK",
"account_id": "b1b89684-c2c4-4d54-b8a8-3572727fd120",
"balance_id": "fb095d8e-eaa1-4014-9410-a291928e301a",
"reference_id": "d3fb10e2-0f7b-4fe8-986c-5abbb2d51ea4",
"transaction_type": "FEE",
"currency": "USD",
"amount": "1.5",
"ending_balance": "11454.38",
"description": "Reason: transaction approved fee",
"create_time": "2026-09-09 16:07:06",
"complete_time": "2026-09-09 16:07:06",
"transaction_status": "COMPLETED"
},
{
"transaction_id": "3488b4c5-86db-471c-857c-c5ce6d0e1220",
"short_transaction_id": "T260909-2PD70I0LGE0W",
"account_id": "b1b89684-c2c4-4d54-b8a8-3572727fd120",
"balance_id": "fb095d8e-eaa1-4014-9410-a291928e301a",
"reference_id": "b53491cf-0c36-4ab3-9771-07ee7d89117e",
"transaction_type": "FEE",
"currency": "USD",
"amount": "1.5",
"ending_balance": "11455.88",
"description": "Reason: transaction approved fee",
"create_time": "2026-09-09 16:07:03",
"complete_time": "2026-09-09 16:07:03",
"transaction_status": "COMPLETED"
},
{
"transaction_id": "87e56169-9d75-46cd-abac-bec2d67e27d6",
"short_transaction_id": "T260909-2PD70QCBRRPC",
"account_id": "b1b89684-c2c4-4d54-b8a8-3572727fd120",
"balance_id": "fb095d8e-eaa1-4014-9410-a291928e301a",
"reference_id": "72691771-811a-45f5-9e38-586a8e9d8e44",
"transaction_type": "ISSUING_REVERSAL",
"currency": "USD",
"amount": "0.1",
"ending_balance": "11457.38",
"description": "Card reversal approve transaction",
"create_time": "2026-09-09 16:07:03",
"complete_time": "2026-09-09 16:07:03",
"transaction_status": "COMPLETED"
},
{
"transaction_id": "5715a626-6f85-4aeb-a15b-d2dcec62fed9",
"short_transaction_id": "T260909-2PD70P4Z17NK",
"account_id": "b1b89684-c2c4-4d54-b8a8-3572727fd120",
"balance_id": "fb095d8e-eaa1-4014-9410-a291928e301a",
"reference_id": "d3fb10e2-0f7b-4fe8-986c-5abbb2d51ea4",
"transaction_type": "ISSUING_AUTHORIZATION",
"currency": "USD",
"amount": "0.1",
"ending_balance": "11457.28",
"description": "Card authorization approval transaction",
"create_time": "2026-09-09 16:07:03",
"complete_time": "2026-09-09 16:07:03",
"transaction_status": "COMPLETED"
},
{
"transaction_id": "a77b6c6b-636b-4e91-9744-66223e35abc7",
"short_transaction_id": "T260909-2PD70FNREJ9C",
"account_id": "b1b89684-c2c4-4d54-b8a8-3572727fd120",
"balance_id": "fb095d8e-eaa1-4014-9410-a291928e301a",
"reference_id": "4aaef847-5f90-4e86-9691-ffd8a8ec96d4",
"transaction_type": "FEE",
"currency": "USD",
"amount": "1.5",
"ending_balance": "11457.38",
"description": "Reason: transaction approved fee",
"create_time": "2026-09-09 16:07:02",
"complete_time": "2026-09-09 16:07:02",
"transaction_status": "COMPLETED"
},
{
"transaction_id": "d68bcf49-29c0-4431-98e2-f75a035bdeeb",
"short_transaction_id": "T260909-2PD70N0QMRR4",
"account_id": "b1b89684-c2c4-4d54-b8a8-3572727fd120",
"balance_id": "fb095d8e-eaa1-4014-9410-a291928e301a",
"reference_id": "b8defc70-bca1-43d9-8814-0388ca7b371e",
"transaction_type": "ISSUING_REFUND",
"currency": "USD",
"amount": "0.1",
"ending_balance": "11458.88",
"description": "Card refund approve transaction",
"create_time": "2026-09-09 16:07:02",
"complete_time": "2026-09-09 16:07:02",
"transaction_status": "COMPLETED"
},
{
"transaction_id": "62b9a8a6-416b-4884-95a7-da0053c17950",
"short_transaction_id": "T260909-2PD70KEQYBCW",
"account_id": "b1b89684-c2c4-4d54-b8a8-3572727fd120",
"balance_id": "fb095d8e-eaa1-4014-9410-a291928e301a",
"reference_id": "bcac3668-03b5-48a9-9d49-ac90de9a3dcd",
"transaction_type": "ISSUING_REFUND",
"currency": "USD",
"amount": "0.01",
"ending_balance": "11458.78",
"description": "Card refund approve transaction",
"create_time": "2026-09-09 16:07:00",
"complete_time": "2026-09-09 16:07:00",
"transaction_status": "COMPLETED"
},
{
"transaction_id": "6f413b66-e196-458d-90af-c71374a4c262",
"short_transaction_id": "T260909-2PD70JPPGYKG",
"account_id": "b1b89684-c2c4-4d54-b8a8-3572727fd120",
"balance_id": "fb095d8e-eaa1-4014-9410-a291928e301a",
"reference_id": "7a759eb5-e9b0-4cab-8d8a-7abdd51ba524",
"transaction_type": "ISSUING_AUTHORIZATION",
"currency": "USD",
"amount": "0.01",
"ending_balance": "11458.77",
"description": "Card authorization approval transaction",
"create_time": "2026-09-09 16:06:59",
"complete_time": "2026-09-09 16:06:59",
"transaction_status": "COMPLETED"
},
{
"transaction_id": "bf3c7543-7bf2-4dd9-95ac-152fa0ff62d1",
"short_transaction_id": "T260909-2PD70I0LGE0W",
"account_id": "b1b89684-c2c4-4d54-b8a8-3572727fd120",
"balance_id": "fb095d8e-eaa1-4014-9410-a291928e301a",
"reference_id": "b53491cf-0c36-4ab3-9771-07ee7d89117e",
"transaction_type": "ISSUING_AUTHORIZATION",
"currency": "USD",
"amount": "0.1",
"ending_balance": "11458.78",
"description": "Card authorization approval transaction",
"create_time": "2026-09-09 16:06:59",
"complete_time": "2026-09-09 16:06:59",
"transaction_status": "COMPLETED"
}
]
}授权
由 UQPAY 提供的登录 API Token。
请求头
指定代表哪个子账户发起请求。应设置为 account_id，该值可通过 List Connected Accounts 接口获取。若省略或为空，则请求以主账户身份执行。
更多信息参见 关联账户。
查询参数
每页返回的最大条目数。取值范围为 10 - 100，默认为 10。
必填范围:
10 <= x <= 100示例:
10
要查询的页码，从 1 开始。
必填范围:
x >= 1示例:
1
用于筛选的最早交易创建时间。start_time 与 end_time 之间的最大时间间隔为 90 天。
示例:
"2024-03-21T17:17:32+08:00"
用于筛选的最晚交易创建时间。start_time 与 end_time 之间的最大时间间隔为 90 天。
示例:
"2024-03-21T17:17:32+08:00"
发卡账户余额交易的交易类型筛选。
可用选项:
ISSUING_AUTHORIZATION, ISSUING_REVERSAL, ISSUING_REFUND, CARD_RECHARGE, CARD_WITHDRAW, FEE, DEPOSIT, TRANSFER_IN, TRANSFER_OUT, SETTLEMENT_DEBIT, SETTLEMENT_CREDIT, ADJUSTMENT, FUNDS_TRANSFER_IN, FUNDS_TRANSFER_OUT, FEE_REFUND, FEE_DEDUCTION, MARGIN_PAYMENT, MARGIN_REFUND, OTHER, SETTLEMENT_REVERSAL, REFUND 示例:
"DEPOSIT"
发卡账户余额交易的交易状态筛选。
可用选项:
COMPLETED, PENDING, FAILED 示例:
"COMPLETED"
币种筛选。三位 ISO 4217 货币代码。
示例:
"USD"
交易 ID 筛选（长 ID）。 交易的唯一标识符。
示例:
"5135e6cc-28b6-4889-81dc-3b86a09e1395"