curl --request GET \
--url "https://api.stablepay.co/api/v1/recipient" \
--header "Authorization: Bearer <API_KEY>" \
--header "X-StablePay-Timestamp: <TIMESTAMP>" \
--header "X-StablePay-Nonce: <NONCE>" \
--header "X-StablePay-Signature: <SIGNATURE>"
const response = await fetch("https://api.stablepay.co/api/v1/recipient", {
method: "GET",
headers: {
"Authorization": "Bearer <API_KEY>",
"X-StablePay-Timestamp": "<TIMESTAMP>",
"X-StablePay-Nonce": "<NONCE>",
"X-StablePay-Signature": "<SIGNATURE>"
}
});
console.log(await response.json());
{
"recipients": [
{
"recipient_id": "9000000080",
"merchant_id": "2000000001",
"type": "stablecoin_address",
"currency": "USDC",
"is_third_party": true,
"name": "Supplier A",
"network": "solana",
"details": {
"address": "4fYNw3dojWmQ4dXtSGE9epjRGy9pFSx62YymTvAVmRoz"
},
"created": 1718726401
}
],
"next_cursor": "eyJpZCI6IjkwMDAwMDAwODAifQ"
}
全球账户 API
收款人列表
收款人列表
GET
/
api
/
v1
/
recipient
curl --request GET \
--url "https://api.stablepay.co/api/v1/recipient" \
--header "Authorization: Bearer <API_KEY>" \
--header "X-StablePay-Timestamp: <TIMESTAMP>" \
--header "X-StablePay-Nonce: <NONCE>" \
--header "X-StablePay-Signature: <SIGNATURE>"
const response = await fetch("https://api.stablepay.co/api/v1/recipient", {
method: "GET",
headers: {
"Authorization": "Bearer <API_KEY>",
"X-StablePay-Timestamp": "<TIMESTAMP>",
"X-StablePay-Nonce": "<NONCE>",
"X-StablePay-Signature": "<SIGNATURE>"
}
});
console.log(await response.json());
{
"recipients": [
{
"recipient_id": "9000000080",
"merchant_id": "2000000001",
"type": "stablecoin_address",
"currency": "USDC",
"is_third_party": true,
"name": "Supplier A",
"network": "solana",
"details": {
"address": "4fYNw3dojWmQ4dXtSGE9epjRGy9pFSx62YymTvAVmRoz"
},
"created": 1718726401
}
],
"next_cursor": "eyJpZCI6IjkwMDAwMDAwODAifQ"
}
完整认证、签名、数据约定与错误响应。每次重试均须重新生成时间戳、nonce 与签名。
GET /recipient 按类型与币种过滤,游标分页。
请求头
string
必填
Bearer API Key。
string
必填
Unix 秒,允许与服务端相差最多 5 分钟。
string
必填
每次请求唯一的随机串,16–64 字符。
string
必填
HMAC-SHA256 签名,小写十六进制;签名必须对应实际发送的请求体。
请求参数
string
10 位数字;商户 App 不传,服务商 App 传值指定作用商户
string
按类型过滤
string
按币种过滤
integer
每页条数,默认 20,最大 100
string
上一页返回的游标
响应
array
必填
收款人数组
string
还有下一页时返回
string
必填
收款人 ID,10 位数字
string
必填
商户 ID
string
业务参考号
string
必填
stablecoin_address 或 fiat_accountstring
必填
打款币种
boolean
必填
是否第三方
string
展示名称
string
稳定币地址网络
object
必填
地址与 memo,或银行字段
integer
必填
创建时间
integer
更新时间
状态与错误
400 参数不合法。curl --request GET \
--url "https://api.stablepay.co/api/v1/recipient" \
--header "Authorization: Bearer <API_KEY>" \
--header "X-StablePay-Timestamp: <TIMESTAMP>" \
--header "X-StablePay-Nonce: <NONCE>" \
--header "X-StablePay-Signature: <SIGNATURE>"
const response = await fetch("https://api.stablepay.co/api/v1/recipient", {
method: "GET",
headers: {
"Authorization": "Bearer <API_KEY>",
"X-StablePay-Timestamp": "<TIMESTAMP>",
"X-StablePay-Nonce": "<NONCE>",
"X-StablePay-Signature": "<SIGNATURE>"
}
});
console.log(await response.json());
{
"recipients": [
{
"recipient_id": "9000000080",
"merchant_id": "2000000001",
"type": "stablecoin_address",
"currency": "USDC",
"is_third_party": true,
"name": "Supplier A",
"network": "solana",
"details": {
"address": "4fYNw3dojWmQ4dXtSGE9epjRGy9pFSx62YymTvAVmRoz"
},
"created": 1718726401
}
],
"next_cursor": "eyJpZCI6IjkwMDAwMDAwODAifQ"
}
最后修改于 2026年10月29日
此页面对您有帮助吗?
