curl --request POST \
--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>" \
--header "Content-Type: application/json" \
--data '{
"type": "stablecoin_address",
"currency": "USDC",
"is_third_party": true,
"name": "Supplier A",
"network": "solana",
"details": {
"address": "4fYNw3dojWmQ4dXtSGE9epjRGy9pFSx62YymTvAVmRoz"
}
}'
const response = await fetch("https://api.stablepay.co/api/v1/recipient", {
method: "POST",
headers: {
"Authorization": "Bearer <API_KEY>",
"X-StablePay-Timestamp": "<TIMESTAMP>",
"X-StablePay-Nonce": "<NONCE>",
"X-StablePay-Signature": "<SIGNATURE>",
"Content-Type": "application/json"
},
body: JSON.stringify({
"type": "stablecoin_address",
"currency": "USDC",
"is_third_party": true,
"name": "Supplier A",
"network": "solana",
"details": {
"address": "4fYNw3dojWmQ4dXtSGE9epjRGy9pFSx62YymTvAVmRoz"
}
})
});
console.log(await response.json());
{
"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
}
全球账户 API
创建收款人
创建收款人
POST
/
api
/
v1
/
recipient
curl --request POST \
--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>" \
--header "Content-Type: application/json" \
--data '{
"type": "stablecoin_address",
"currency": "USDC",
"is_third_party": true,
"name": "Supplier A",
"network": "solana",
"details": {
"address": "4fYNw3dojWmQ4dXtSGE9epjRGy9pFSx62YymTvAVmRoz"
}
}'
const response = await fetch("https://api.stablepay.co/api/v1/recipient", {
method: "POST",
headers: {
"Authorization": "Bearer <API_KEY>",
"X-StablePay-Timestamp": "<TIMESTAMP>",
"X-StablePay-Nonce": "<NONCE>",
"X-StablePay-Signature": "<SIGNATURE>",
"Content-Type": "application/json"
},
body: JSON.stringify({
"type": "stablecoin_address",
"currency": "USDC",
"is_third_party": true,
"name": "Supplier A",
"network": "solana",
"details": {
"address": "4fYNw3dojWmQ4dXtSGE9epjRGy9pFSx62YymTvAVmRoz"
}
})
});
console.log(await response.json());
{
"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
}
完整认证、签名、数据约定与错误响应。每次重试均须重新生成时间戳、nonce 与签名。
POST /recipient 创建打款目的方,type、currency 与 is_third_party 创建后不可改。
请求头
string
必填
Bearer API Key。
string
必填
Unix 秒,允许与服务端相差最多 5 分钟。
string
必填
每次请求唯一的随机串,16–64 字符。
string
必填
HMAC-SHA256 签名,小写十六进制;签名必须对应实际发送的请求体。
string
幂等键
请求参数
string
10 位数字;商户 App 不传,服务商 App 必传
string
业务参考号
string
必填
stablecoin_address 或 fiat_accountstring
必填
打款币种
boolean
必填
true 第三方、false 本主体
string
展示名称,最长 140 字符
string
stablecoin_address 时必填object
必填
地址与 memo,或银行字段
响应
string
必填
收款人 ID,10 位数字
string
必填
商户 ID
string
业务参考号
string
必填
stablecoin_address 或 fiat_accountstring
必填
打款币种
boolean
必填
是否第三方
string
展示名称
string
稳定币地址网络
object
必填
地址与 memo,或银行字段
integer
必填
创建时间
integer
更新时间
状态与错误
400 参数不合法或缺少必填银行字段。curl --request POST \
--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>" \
--header "Content-Type: application/json" \
--data '{
"type": "stablecoin_address",
"currency": "USDC",
"is_third_party": true,
"name": "Supplier A",
"network": "solana",
"details": {
"address": "4fYNw3dojWmQ4dXtSGE9epjRGy9pFSx62YymTvAVmRoz"
}
}'
const response = await fetch("https://api.stablepay.co/api/v1/recipient", {
method: "POST",
headers: {
"Authorization": "Bearer <API_KEY>",
"X-StablePay-Timestamp": "<TIMESTAMP>",
"X-StablePay-Nonce": "<NONCE>",
"X-StablePay-Signature": "<SIGNATURE>",
"Content-Type": "application/json"
},
body: JSON.stringify({
"type": "stablecoin_address",
"currency": "USDC",
"is_third_party": true,
"name": "Supplier A",
"network": "solana",
"details": {
"address": "4fYNw3dojWmQ4dXtSGE9epjRGy9pFSx62YymTvAVmRoz"
}
})
});
console.log(await response.json());
{
"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
}
最后修改于 2026年10月29日
此页面对您有帮助吗?
