transaction details on chain
curl --request GET \
--url https://openplatform.gateapi.io/payment/open/institution/v1/pay/address/transactiondetail \
--header 'X-GatePay-Certificate-ClientId: <x-gatepay-certificate-clientid>' \
--header 'X-GatePay-Nonce: <x-gatepay-nonce>' \
--header 'X-GatePay-On-Behalf-Of: <x-gatepay-on-behalf-of>' \
--header 'X-GatePay-Signature: <x-gatepay-signature>' \
--header 'X-GatePay-Timestamp: <x-gatepay-timestamp>'import requests
url = "https://openplatform.gateapi.io/payment/open/institution/v1/pay/address/transactiondetail"
headers = {
"X-GatePay-Certificate-ClientId": "<x-gatepay-certificate-clientid>",
"X-GatePay-Signature": "<x-gatepay-signature>",
"X-GatePay-Timestamp": "<x-gatepay-timestamp>",
"X-GatePay-Nonce": "<x-gatepay-nonce>",
"X-GatePay-On-Behalf-Of": "<x-gatepay-on-behalf-of>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'X-GatePay-Certificate-ClientId': '<x-gatepay-certificate-clientid>',
'X-GatePay-Signature': '<x-gatepay-signature>',
'X-GatePay-Timestamp': '<x-gatepay-timestamp>',
'X-GatePay-Nonce': '<x-gatepay-nonce>',
'X-GatePay-On-Behalf-Of': '<x-gatepay-on-behalf-of>'
}
};
fetch('https://openplatform.gateapi.io/payment/open/institution/v1/pay/address/transactiondetail', 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://openplatform.gateapi.io/payment/open/institution/v1/pay/address/transactiondetail",
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-GatePay-Certificate-ClientId: <x-gatepay-certificate-clientid>",
"X-GatePay-Nonce: <x-gatepay-nonce>",
"X-GatePay-On-Behalf-Of: <x-gatepay-on-behalf-of>",
"X-GatePay-Signature: <x-gatepay-signature>",
"X-GatePay-Timestamp: <x-gatepay-timestamp>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}HttpResponse<String> response = Unirest.get("https://openplatform.gateapi.io/payment/open/institution/v1/pay/address/transactiondetail")
.header("X-GatePay-Certificate-ClientId", "<x-gatepay-certificate-clientid>")
.header("X-GatePay-Signature", "<x-gatepay-signature>")
.header("X-GatePay-Timestamp", "<x-gatepay-timestamp>")
.header("X-GatePay-Nonce", "<x-gatepay-nonce>")
.header("X-GatePay-On-Behalf-Of", "<x-gatepay-on-behalf-of>")
.asString();package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://openplatform.gateapi.io/payment/open/institution/v1/pay/address/transactiondetail"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-GatePay-Certificate-ClientId", "<x-gatepay-certificate-clientid>")
req.Header.Add("X-GatePay-Signature", "<x-gatepay-signature>")
req.Header.Add("X-GatePay-Timestamp", "<x-gatepay-timestamp>")
req.Header.Add("X-GatePay-Nonce", "<x-gatepay-nonce>")
req.Header.Add("X-GatePay-On-Behalf-Of", "<x-gatepay-on-behalf-of>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}require 'uri'
require 'net/http'
url = URI("https://openplatform.gateapi.io/payment/open/institution/v1/pay/address/transactiondetail")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-GatePay-Certificate-ClientId"] = '<x-gatepay-certificate-clientid>'
request["X-GatePay-Signature"] = '<x-gatepay-signature>'
request["X-GatePay-Timestamp"] = '<x-gatepay-timestamp>'
request["X-GatePay-Nonce"] = '<x-gatepay-nonce>'
request["X-GatePay-On-Behalf-Of"] = '<x-gatepay-on-behalf-of>'
response = http.request(request)
puts response.read_body{
"status": "SUCCESS",
"code": "000000",
"errorMessage": "",
"data": {
"prepayId": "40100646616043520",
"merchantId": 10002,
"merchantTradeNo": "9384029384092499",
"transactionId": "1671522905110477",
"goodsName": "",
"currency": "BTC",
"orderAmount": "212.999",
"payCurrency": "BTC",
"payAmount": "212.999",
"status": "EXPIRED",
"utcCreateTime": "2022-12-20 07:45:39",
"utcExpireTime": "2022-12-20 07:55:00",
"utcUpdateTime": "2022-12-20 07:46:00",
"transactTime": 1671522905110,
"order_name": "MiniApp-Payment-1#9384029384092499",
"channelId": "123456",
"transactionDetail": {
"inTerm": {
"done": {
"amount": "100",
"txList": [
{
"chain": "BTC",
"address": "12eBREQqZFFDqgDfXkuBdzW2KBwhU8amPn",
"fromAddress": "PAzupoupdSYaYoajDcABEUzigBRzewvzN",
"fullCurrType": "BTC",
"amount": "100",
"txId": "dosajdajdiojawojdoiwajdojaefhs",
"utcCreateTime": "2022-12-19 11:49:00",
"utcUpdateTime": "2022-12-19 11:50:00",
"utcConfirmingTime": "2022-12-19 11:51:00",
"complianceStatus": "ACCEPTED",
"utcDoneTime": "2022-12-19 11:52:00"
}
]
},
"wait": {
"amount": "99",
"txList": [
{
"chain": "BTC",
"address": "12eBREQqZFFDqgDfXkuBdzW2KBwhU8amPn",
"fromAddress": "PAzupoupdSYaYoajDcABEUzigBRzewvzN",
"fullCurrType": "BTC",
"amount": "99",
"txId": "dosajdajdiojawojdoiwajdojaikjs",
"utcCreateTime": "2022-12-19 11:49:30",
"utcUpdateTime": "2022-12-19 11:50:00",
"utcConfirmingTime": "2022-12-19 11:51:30",
"complianceStatus": "PEND"
}
]
}
},
"outOfTerm": {
"done": {
"amount": "98",
"txList": [
{
"chain": "BTC",
"address": "12eBREQqZFFDqgDfXkuBdzW2KBwhU8amPn",
"fromAddress": "PAzupoupdSYaYoajDcABEUzigBRzewvzN",
"fullCurrType": "BTC",
"amount": "98",
"txId": "dosajdajdoakawojdoiwajdojaikjs",
"utcCreateTime": "2022-12-19 11:55:00",
"utcUpdateTime": "2022-12-19 11:56:00",
"utcConfirmingTime": "2022-12-19 11:57:00",
"complianceStatus": "ACCEPTED",
"utcDoneTime": "2022-12-19 11:58:00"
}
]
},
"wait": {
"amount": "193",
"txList": [
{
"chain": "BTC",
"address": "12eBREQqZFFDqgDfXkuBdzW2KBwhU8amPn",
"fromAddress": "PAzupoupdSYaYoajDcABEUzigBRzewvzN",
"fullCurrType": "BTC",
"amount": "97",
"txId": "dosajdajdiojawolakiwajdojaikjs",
"utcCreateTime": "2022-12-19 11:55:30",
"utcUpdateTime": "2022-12-19 11:56:00",
"complianceStatus": "REJECTED"
},
{
"chain": "BTC",
"address": "12eBREQqZFFDqgDfXkuBdzW2KBwhU8amPn",
"fromAddress": "PAzupoupdSYaYoajDcABEUzigBRzewvzN",
"fullCurrType": "BTC",
"amount": "96",
"txId": "dosajdajdiojawolakiwajdppaikjs",
"utcCreateTime": "2022-12-19 11:55:45",
"utcUpdateTime": "2022-12-19 11:56:00",
"utcConfirmingTime": "2022-12-19 11:57:30",
"complianceStatus": "PEND"
}
]
}
}
}
}
}Address Payment
Query On-chain Transaction Detail
Query the transaction details of the address direct payment order on the chain, including the direct payment record within the validity period and the payment record beyond the validity period.
GET
/
payment
/
open
/
institution
/
v1
/
pay
/
address
/
transactiondetail
transaction details on chain
curl --request GET \
--url https://openplatform.gateapi.io/payment/open/institution/v1/pay/address/transactiondetail \
--header 'X-GatePay-Certificate-ClientId: <x-gatepay-certificate-clientid>' \
--header 'X-GatePay-Nonce: <x-gatepay-nonce>' \
--header 'X-GatePay-On-Behalf-Of: <x-gatepay-on-behalf-of>' \
--header 'X-GatePay-Signature: <x-gatepay-signature>' \
--header 'X-GatePay-Timestamp: <x-gatepay-timestamp>'import requests
url = "https://openplatform.gateapi.io/payment/open/institution/v1/pay/address/transactiondetail"
headers = {
"X-GatePay-Certificate-ClientId": "<x-gatepay-certificate-clientid>",
"X-GatePay-Signature": "<x-gatepay-signature>",
"X-GatePay-Timestamp": "<x-gatepay-timestamp>",
"X-GatePay-Nonce": "<x-gatepay-nonce>",
"X-GatePay-On-Behalf-Of": "<x-gatepay-on-behalf-of>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'X-GatePay-Certificate-ClientId': '<x-gatepay-certificate-clientid>',
'X-GatePay-Signature': '<x-gatepay-signature>',
'X-GatePay-Timestamp': '<x-gatepay-timestamp>',
'X-GatePay-Nonce': '<x-gatepay-nonce>',
'X-GatePay-On-Behalf-Of': '<x-gatepay-on-behalf-of>'
}
};
fetch('https://openplatform.gateapi.io/payment/open/institution/v1/pay/address/transactiondetail', 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://openplatform.gateapi.io/payment/open/institution/v1/pay/address/transactiondetail",
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-GatePay-Certificate-ClientId: <x-gatepay-certificate-clientid>",
"X-GatePay-Nonce: <x-gatepay-nonce>",
"X-GatePay-On-Behalf-Of: <x-gatepay-on-behalf-of>",
"X-GatePay-Signature: <x-gatepay-signature>",
"X-GatePay-Timestamp: <x-gatepay-timestamp>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}HttpResponse<String> response = Unirest.get("https://openplatform.gateapi.io/payment/open/institution/v1/pay/address/transactiondetail")
.header("X-GatePay-Certificate-ClientId", "<x-gatepay-certificate-clientid>")
.header("X-GatePay-Signature", "<x-gatepay-signature>")
.header("X-GatePay-Timestamp", "<x-gatepay-timestamp>")
.header("X-GatePay-Nonce", "<x-gatepay-nonce>")
.header("X-GatePay-On-Behalf-Of", "<x-gatepay-on-behalf-of>")
.asString();package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://openplatform.gateapi.io/payment/open/institution/v1/pay/address/transactiondetail"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-GatePay-Certificate-ClientId", "<x-gatepay-certificate-clientid>")
req.Header.Add("X-GatePay-Signature", "<x-gatepay-signature>")
req.Header.Add("X-GatePay-Timestamp", "<x-gatepay-timestamp>")
req.Header.Add("X-GatePay-Nonce", "<x-gatepay-nonce>")
req.Header.Add("X-GatePay-On-Behalf-Of", "<x-gatepay-on-behalf-of>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}require 'uri'
require 'net/http'
url = URI("https://openplatform.gateapi.io/payment/open/institution/v1/pay/address/transactiondetail")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-GatePay-Certificate-ClientId"] = '<x-gatepay-certificate-clientid>'
request["X-GatePay-Signature"] = '<x-gatepay-signature>'
request["X-GatePay-Timestamp"] = '<x-gatepay-timestamp>'
request["X-GatePay-Nonce"] = '<x-gatepay-nonce>'
request["X-GatePay-On-Behalf-Of"] = '<x-gatepay-on-behalf-of>'
response = http.request(request)
puts response.read_body{
"status": "SUCCESS",
"code": "000000",
"errorMessage": "",
"data": {
"prepayId": "40100646616043520",
"merchantId": 10002,
"merchantTradeNo": "9384029384092499",
"transactionId": "1671522905110477",
"goodsName": "",
"currency": "BTC",
"orderAmount": "212.999",
"payCurrency": "BTC",
"payAmount": "212.999",
"status": "EXPIRED",
"utcCreateTime": "2022-12-20 07:45:39",
"utcExpireTime": "2022-12-20 07:55:00",
"utcUpdateTime": "2022-12-20 07:46:00",
"transactTime": 1671522905110,
"order_name": "MiniApp-Payment-1#9384029384092499",
"channelId": "123456",
"transactionDetail": {
"inTerm": {
"done": {
"amount": "100",
"txList": [
{
"chain": "BTC",
"address": "12eBREQqZFFDqgDfXkuBdzW2KBwhU8amPn",
"fromAddress": "PAzupoupdSYaYoajDcABEUzigBRzewvzN",
"fullCurrType": "BTC",
"amount": "100",
"txId": "dosajdajdiojawojdoiwajdojaefhs",
"utcCreateTime": "2022-12-19 11:49:00",
"utcUpdateTime": "2022-12-19 11:50:00",
"utcConfirmingTime": "2022-12-19 11:51:00",
"complianceStatus": "ACCEPTED",
"utcDoneTime": "2022-12-19 11:52:00"
}
]
},
"wait": {
"amount": "99",
"txList": [
{
"chain": "BTC",
"address": "12eBREQqZFFDqgDfXkuBdzW2KBwhU8amPn",
"fromAddress": "PAzupoupdSYaYoajDcABEUzigBRzewvzN",
"fullCurrType": "BTC",
"amount": "99",
"txId": "dosajdajdiojawojdoiwajdojaikjs",
"utcCreateTime": "2022-12-19 11:49:30",
"utcUpdateTime": "2022-12-19 11:50:00",
"utcConfirmingTime": "2022-12-19 11:51:30",
"complianceStatus": "PEND"
}
]
}
},
"outOfTerm": {
"done": {
"amount": "98",
"txList": [
{
"chain": "BTC",
"address": "12eBREQqZFFDqgDfXkuBdzW2KBwhU8amPn",
"fromAddress": "PAzupoupdSYaYoajDcABEUzigBRzewvzN",
"fullCurrType": "BTC",
"amount": "98",
"txId": "dosajdajdoakawojdoiwajdojaikjs",
"utcCreateTime": "2022-12-19 11:55:00",
"utcUpdateTime": "2022-12-19 11:56:00",
"utcConfirmingTime": "2022-12-19 11:57:00",
"complianceStatus": "ACCEPTED",
"utcDoneTime": "2022-12-19 11:58:00"
}
]
},
"wait": {
"amount": "193",
"txList": [
{
"chain": "BTC",
"address": "12eBREQqZFFDqgDfXkuBdzW2KBwhU8amPn",
"fromAddress": "PAzupoupdSYaYoajDcABEUzigBRzewvzN",
"fullCurrType": "BTC",
"amount": "97",
"txId": "dosajdajdiojawolakiwajdojaikjs",
"utcCreateTime": "2022-12-19 11:55:30",
"utcUpdateTime": "2022-12-19 11:56:00",
"complianceStatus": "REJECTED"
},
{
"chain": "BTC",
"address": "12eBREQqZFFDqgDfXkuBdzW2KBwhU8amPn",
"fromAddress": "PAzupoupdSYaYoajDcABEUzigBRzewvzN",
"fullCurrType": "BTC",
"amount": "96",
"txId": "dosajdajdiojawolakiwajdppaikjs",
"utcCreateTime": "2022-12-19 11:55:45",
"utcUpdateTime": "2022-12-19 11:56:00",
"utcConfirmingTime": "2022-12-19 11:57:30",
"complianceStatus": "PEND"
}
]
}
}
}
}
}Overview
This page documents theGET /payment/open/institution/v1/pay/address/transactiondetail endpoint. The full schema, parameters, and examples are rendered from the linked OpenAPI definition above.
Query the transaction details of the address direct payment order on the chain, including the direct payment record within the validity period and the payment record beyond the validity period.
Notes
- Authentication uses the standard GatePay signed headers.
- This page documents the standard merchant endpoint.
- For shared signing rules, see /api-reference/version/100/en/common/securityAndSignature.
Headers
Merchant client ID, obtained from GatePay platform
HMAC-SHA256 signature for request validation
Millisecond timestamp; the difference from server time must not exceed 30 seconds.
Random nonce for replay attack prevention
Required delegated-subject header. Provide the initiating account ID for this request. For institution merchant APIs, this is typically the target sub-account ID; for institution charge and transfer APIs, it can be either an institution account ID or a sub-account ID.
Query Parameters
The ID of the Address Payment prepayment order
⌘I