实时余额查询
curl --request POST \
--url https://mpgwpre.payallglobal.com/mp-gateway/api/mapi/v1/payments/open/api/currentBalanceQuery \
--header 'Content-Type: application/json' \
--header 'signature: <api-key>' \
--data '
{
"charset": "UTF-8",
"version": "2.0.0",
"transType": "BALANCE_QUERY",
"accessType": "s2s",
"signType": "RSA",
"memberId": "2023010558663764",
"merchantId": "2023010558663764",
"requestTime": "2025-04-05T12:00:00.000+08:00",
"data": {
"accountType": [
"ACQUIRING",
"SETTLE"
],
"accountCurrency": "USD"
}
}
'import requests
url = "https://mpgwpre.payallglobal.com/mp-gateway/api/mapi/v1/payments/open/api/currentBalanceQuery"
payload = {
"charset": "UTF-8",
"version": "2.0.0",
"transType": "BALANCE_QUERY",
"accessType": "s2s",
"signType": "RSA",
"memberId": "2023010558663764",
"merchantId": "2023010558663764",
"requestTime": "2025-04-05T12:00:00.000+08:00",
"data": {
"accountType": ["ACQUIRING", "SETTLE"],
"accountCurrency": "USD"
}
}
headers = {
"signature": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {signature: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
charset: 'UTF-8',
version: '2.0.0',
transType: 'BALANCE_QUERY',
accessType: 's2s',
signType: 'RSA',
memberId: '2023010558663764',
merchantId: '2023010558663764',
requestTime: '2025-04-05T12:00:00.000+08:00',
data: {accountType: ['ACQUIRING', 'SETTLE'], accountCurrency: 'USD'}
})
};
fetch('https://mpgwpre.payallglobal.com/mp-gateway/api/mapi/v1/payments/open/api/currentBalanceQuery', 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://mpgwpre.payallglobal.com/mp-gateway/api/mapi/v1/payments/open/api/currentBalanceQuery",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'charset' => 'UTF-8',
'version' => '2.0.0',
'transType' => 'BALANCE_QUERY',
'accessType' => 's2s',
'signType' => 'RSA',
'memberId' => '2023010558663764',
'merchantId' => '2023010558663764',
'requestTime' => '2025-04-05T12:00:00.000+08:00',
'data' => [
'accountType' => [
'ACQUIRING',
'SETTLE'
],
'accountCurrency' => 'USD'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"signature: <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"
"strings"
"net/http"
"io"
)
func main() {
url := "https://mpgwpre.payallglobal.com/mp-gateway/api/mapi/v1/payments/open/api/currentBalanceQuery"
payload := strings.NewReader("{\n \"charset\": \"UTF-8\",\n \"version\": \"2.0.0\",\n \"transType\": \"BALANCE_QUERY\",\n \"accessType\": \"s2s\",\n \"signType\": \"RSA\",\n \"memberId\": \"2023010558663764\",\n \"merchantId\": \"2023010558663764\",\n \"requestTime\": \"2025-04-05T12:00:00.000+08:00\",\n \"data\": {\n \"accountType\": [\n \"ACQUIRING\",\n \"SETTLE\"\n ],\n \"accountCurrency\": \"USD\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("signature", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://mpgwpre.payallglobal.com/mp-gateway/api/mapi/v1/payments/open/api/currentBalanceQuery")
.header("signature", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"charset\": \"UTF-8\",\n \"version\": \"2.0.0\",\n \"transType\": \"BALANCE_QUERY\",\n \"accessType\": \"s2s\",\n \"signType\": \"RSA\",\n \"memberId\": \"2023010558663764\",\n \"merchantId\": \"2023010558663764\",\n \"requestTime\": \"2025-04-05T12:00:00.000+08:00\",\n \"data\": {\n \"accountType\": [\n \"ACQUIRING\",\n \"SETTLE\"\n ],\n \"accountCurrency\": \"USD\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://mpgwpre.payallglobal.com/mp-gateway/api/mapi/v1/payments/open/api/currentBalanceQuery")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["signature"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"charset\": \"UTF-8\",\n \"version\": \"2.0.0\",\n \"transType\": \"BALANCE_QUERY\",\n \"accessType\": \"s2s\",\n \"signType\": \"RSA\",\n \"memberId\": \"2023010558663764\",\n \"merchantId\": \"2023010558663764\",\n \"requestTime\": \"2025-04-05T12:00:00.000+08:00\",\n \"data\": {\n \"accountType\": [\n \"ACQUIRING\",\n \"SETTLE\"\n ],\n \"accountCurrency\": \"USD\"\n }\n}"
response = http.request(request)
puts response.read_body{
"code": "00000000",
"msg": "Success",
"data": {
"accountRealTimeTypes": [
{
"balance": 0.59,
"accountType": "ACQUIRING",
"currency": "AED"
},
{
"balance": 776.34,
"accountType": "ACQUIRING",
"currency": "USD"
}
],
"inquiryTime": "2025-04-05T12:00:00.000+08:00"
}
}多币种资金管理
实时余额查询
POST
/
api
/
mapi
/
v1
/
payments
/
open
/
api
/
currentBalanceQuery
实时余额查询
curl --request POST \
--url https://mpgwpre.payallglobal.com/mp-gateway/api/mapi/v1/payments/open/api/currentBalanceQuery \
--header 'Content-Type: application/json' \
--header 'signature: <api-key>' \
--data '
{
"charset": "UTF-8",
"version": "2.0.0",
"transType": "BALANCE_QUERY",
"accessType": "s2s",
"signType": "RSA",
"memberId": "2023010558663764",
"merchantId": "2023010558663764",
"requestTime": "2025-04-05T12:00:00.000+08:00",
"data": {
"accountType": [
"ACQUIRING",
"SETTLE"
],
"accountCurrency": "USD"
}
}
'import requests
url = "https://mpgwpre.payallglobal.com/mp-gateway/api/mapi/v1/payments/open/api/currentBalanceQuery"
payload = {
"charset": "UTF-8",
"version": "2.0.0",
"transType": "BALANCE_QUERY",
"accessType": "s2s",
"signType": "RSA",
"memberId": "2023010558663764",
"merchantId": "2023010558663764",
"requestTime": "2025-04-05T12:00:00.000+08:00",
"data": {
"accountType": ["ACQUIRING", "SETTLE"],
"accountCurrency": "USD"
}
}
headers = {
"signature": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {signature: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
charset: 'UTF-8',
version: '2.0.0',
transType: 'BALANCE_QUERY',
accessType: 's2s',
signType: 'RSA',
memberId: '2023010558663764',
merchantId: '2023010558663764',
requestTime: '2025-04-05T12:00:00.000+08:00',
data: {accountType: ['ACQUIRING', 'SETTLE'], accountCurrency: 'USD'}
})
};
fetch('https://mpgwpre.payallglobal.com/mp-gateway/api/mapi/v1/payments/open/api/currentBalanceQuery', 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://mpgwpre.payallglobal.com/mp-gateway/api/mapi/v1/payments/open/api/currentBalanceQuery",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'charset' => 'UTF-8',
'version' => '2.0.0',
'transType' => 'BALANCE_QUERY',
'accessType' => 's2s',
'signType' => 'RSA',
'memberId' => '2023010558663764',
'merchantId' => '2023010558663764',
'requestTime' => '2025-04-05T12:00:00.000+08:00',
'data' => [
'accountType' => [
'ACQUIRING',
'SETTLE'
],
'accountCurrency' => 'USD'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"signature: <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"
"strings"
"net/http"
"io"
)
func main() {
url := "https://mpgwpre.payallglobal.com/mp-gateway/api/mapi/v1/payments/open/api/currentBalanceQuery"
payload := strings.NewReader("{\n \"charset\": \"UTF-8\",\n \"version\": \"2.0.0\",\n \"transType\": \"BALANCE_QUERY\",\n \"accessType\": \"s2s\",\n \"signType\": \"RSA\",\n \"memberId\": \"2023010558663764\",\n \"merchantId\": \"2023010558663764\",\n \"requestTime\": \"2025-04-05T12:00:00.000+08:00\",\n \"data\": {\n \"accountType\": [\n \"ACQUIRING\",\n \"SETTLE\"\n ],\n \"accountCurrency\": \"USD\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("signature", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://mpgwpre.payallglobal.com/mp-gateway/api/mapi/v1/payments/open/api/currentBalanceQuery")
.header("signature", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"charset\": \"UTF-8\",\n \"version\": \"2.0.0\",\n \"transType\": \"BALANCE_QUERY\",\n \"accessType\": \"s2s\",\n \"signType\": \"RSA\",\n \"memberId\": \"2023010558663764\",\n \"merchantId\": \"2023010558663764\",\n \"requestTime\": \"2025-04-05T12:00:00.000+08:00\",\n \"data\": {\n \"accountType\": [\n \"ACQUIRING\",\n \"SETTLE\"\n ],\n \"accountCurrency\": \"USD\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://mpgwpre.payallglobal.com/mp-gateway/api/mapi/v1/payments/open/api/currentBalanceQuery")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["signature"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"charset\": \"UTF-8\",\n \"version\": \"2.0.0\",\n \"transType\": \"BALANCE_QUERY\",\n \"accessType\": \"s2s\",\n \"signType\": \"RSA\",\n \"memberId\": \"2023010558663764\",\n \"merchantId\": \"2023010558663764\",\n \"requestTime\": \"2025-04-05T12:00:00.000+08:00\",\n \"data\": {\n \"accountType\": [\n \"ACQUIRING\",\n \"SETTLE\"\n ],\n \"accountCurrency\": \"USD\"\n }\n}"
response = http.request(request)
puts response.read_body{
"code": "00000000",
"msg": "Success",
"data": {
"accountRealTimeTypes": [
{
"balance": 0.59,
"accountType": "ACQUIRING",
"currency": "AED"
},
{
"balance": 776.34,
"accountType": "ACQUIRING",
"currency": "USD"
}
],
"inquiryTime": "2025-04-05T12:00:00.000+08:00"
}
}Authorizations
Example: MIIEpQIBAAKCAQEA...（Base64编码的签名字符串）
加签
加签是开放平台和商户对于交互消息完整性的校验。加签行为主要发生两个部分：
- 商户服务器端针对向PayAllGlobal开放平台发送的请求报文进行加签；
- PayAllGlobal开放平台针对通知商户的异步消息进行加签。 PayAllGlobal平台要求使用 RSA 私钥进行加签， 使用 RSA 公钥进行验签。 因此，在以上两部分描述的交互中， 存在商户公私钥、PayAllGlobal 公私钥，开发者需要使用商户私钥，对第一部分报文进行加签，使用 PayAllGlobal 公钥对第二部分消息进行验签。
加签规则如下:
使用商户私钥对请求体进行 SHA256withRSA 签名后，再进行 Base64 编码的结果。
- 使用 商户私钥对待
request.body进行签名（SHA256WithRSA 计算原始数据的SHA-256哈希值。 使用私钥对哈希值进行签名，即使用私钥对哈希值进行RSA加密。此时得到的加密结果就是数字签名。）；
Signature signature = Signature.getInstance("SHA256withRSA");
signature.initSign(privateKey);
// 计算 SHA256withRSA 签名时，需要以 utf-8 的编码转换 byte 流，否则可能导致含中文参数的签名计算不正确
signature.update(request.body);
byte[] signedHash = signature.sign();
- 将加签内容进行 Base64 编码；
String signature = Base64.getEncoder().encodeToString(signedHash);
- 将编码后的内容放在请求头部 signature 参数中。 注意，加签是对 request.body 进行签名，当查询等 request.body 为空时，则无需加签。
Body
application/json
交互数据的编码【utf-8】
Example:
"UTF-8"
接口版本，当前版本为【2.0.0】,目前只能传2.0.0，不能不传
Example:
"2.0.0"
交易类型
Available options:
PAY, CREDIT_CARD, 3D_PREAUTH_VOIDS, 3D_PREAUTH_COMPLETION, REFUND, VOIDS, QUERY, TRANSFER, DOWNLOAD, REGISTRATION, FILEUPLOAD, INQUIRYREGISTRATIONSTATUS, AUTHORIZE, BALANCE_QUERY 接口访问类型
Example:
"s2s"
报文签名类型
Example:
"RSA"
机构号
Example:
"2023010558663764"
商户号
Example:
"2023010558663764"
请求时间，符合rfc3339规范，格式：yyyy-MM-dd'T'HH:mm:ss.SSSXXX 时间需要在当前时间两分钟内
Maximum string length:
32Example:
"2025-04-05T12:00:00.000+08:00"
Show child attributes
Show child attributes
⌘I