List Virtual Account Applications
curl --request GET \
--url https://api-sandbox.uqpaytech.com/api/v1/virtual/applications \
--header 'x-auth-token: <api-key>'import requests
url = "https://api-sandbox.uqpaytech.com/api/v1/virtual/applications"
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/virtual/applications', 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/virtual/applications",
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/virtual/applications"
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/virtual/applications")
.header("x-auth-token", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-sandbox.uqpaytech.com/api/v1/virtual/applications")
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_pages": 1,
"total_items": 2,
"data": [
{
"account_id": "b1b89684-c2c4-4d54-b8a8-3572727fd120",
"application_id": "550e8400-e29b-41d4-a716-446655440011",
"country": "BH",
"currency": "GBP",
"direct_id": "0",
"public_version": 2,
"status": "COMPLETED",
"created_at": "2026-08-12T06:30:00Z"
},
{
"account_id": "b1b89684-c2c4-4d54-b8a8-3572727fd120",
"application_id": "550e8400-e29b-41d4-a716-446655440012",
"country": "BH",
"currency": "EUR",
"direct_id": "0",
"public_version": 1,
"status": "SUBMITTED",
"created_at": "2026-08-12T05:59:00Z"
}
]
}Virtual Accounts
List Virtual Account Applications
按从新到旧的顺序列出当前认证账户的申请。查询子账户时,请在 x-on-behalf-of 中传入其账户 ID。
page_number 和 page_size 必填。可选的 status、country 和 currency 筛选条件会同时生效。没有匹配结果或页码超出范围时,返回 HTTP 200 和空的 data 数组。
此接口返回申请摘要,不返回已开通的银行信息。申请与银行信息的查询流程详见通过 API 集成虚拟账户。
GET
/
v1
/
virtual
/
applications
List Virtual Account Applications
curl --request GET \
--url https://api-sandbox.uqpaytech.com/api/v1/virtual/applications \
--header 'x-auth-token: <api-key>'import requests
url = "https://api-sandbox.uqpaytech.com/api/v1/virtual/applications"
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/virtual/applications', 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/virtual/applications",
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/virtual/applications"
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/virtual/applications")
.header("x-auth-token", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-sandbox.uqpaytech.com/api/v1/virtual/applications")
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_pages": 1,
"total_items": 2,
"data": [
{
"account_id": "b1b89684-c2c4-4d54-b8a8-3572727fd120",
"application_id": "550e8400-e29b-41d4-a716-446655440011",
"country": "BH",
"currency": "GBP",
"direct_id": "0",
"public_version": 2,
"status": "COMPLETED",
"created_at": "2026-08-12T06:30:00Z"
},
{
"account_id": "b1b89684-c2c4-4d54-b8a8-3572727fd120",
"application_id": "550e8400-e29b-41d4-a716-446655440012",
"country": "BH",
"currency": "EUR",
"direct_id": "0",
"public_version": 1,
"status": "SUBMITTED",
"created_at": "2026-08-12T05:59:00Z"
}
]
}授权
由 UQPAY 提供的登录 API Token。
查询参数
要返回的页码,第一页为 1。
必填范围:
x >= 1示例:
1
每页最多返回的申请数,取值范围为 1 到 100。
必填范围:
1 <= x <= 100示例:
50
只返回具有该整体状态的申请。会去除首尾空格,并接受小写输入。
可用选项:
SUBMITTED, PARTIALLY_COMPLETED, COMPLETED, FAILED, CLOSED 示例:
"SUBMITTED"
只返回该 ISO 3166-1 alpha-2 国家代码对应的申请。会去除首尾空格,并接受小写输入。
示例:
"SG"
只返回该 ISO 4217 币种代码对应的申请。会去除首尾空格,并接受小写输入。
示例:
"USD"

