curl --request GET \
--url "https://api.stablepay.co/api/v1/recipient/requirements?type=<TYPE>" \
--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/requirements?type=<TYPE>", {
method: "GET",
headers: {
"Authorization": "Bearer <API_KEY>",
"X-StablePay-Timestamp": "<TIMESTAMP>",
"X-StablePay-Nonce": "<NONCE>",
"X-StablePay-Signature": "<SIGNATURE>"
}
});
console.log(await response.json());
{
"recipient_requirements": {
"type": "fiat_account",
"currency": "USD",
"fields": [
{
"field": "account_holder_name",
"required": true,
"type": "string",
"max_length": 140,
"description": "Account holder name",
"example": "John Smith"
},
{
"field": "account_number",
"required": true,
"type": "string",
"pattern": "^[0-9]{6,17}$",
"description": "Local account number",
"example": "012345678901"
}
]
}
}
全球账户 API
查询收款人字段规则
查询收款人字段规则
GET
/
api
/
v1
/
recipient
/
requirements
curl --request GET \
--url "https://api.stablepay.co/api/v1/recipient/requirements?type=<TYPE>" \
--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/requirements?type=<TYPE>", {
method: "GET",
headers: {
"Authorization": "Bearer <API_KEY>",
"X-StablePay-Timestamp": "<TIMESTAMP>",
"X-StablePay-Nonce": "<NONCE>",
"X-StablePay-Signature": "<SIGNATURE>"
}
});
console.log(await response.json());
{
"recipient_requirements": {
"type": "fiat_account",
"currency": "USD",
"fields": [
{
"field": "account_holder_name",
"required": true,
"type": "string",
"max_length": 140,
"description": "Account holder name",
"example": "John Smith"
},
{
"field": "account_number",
"required": true,
"type": "string",
"pattern": "^[0-9]{6,17}$",
"description": "Local account number",
"example": "012345678901"
}
]
}
}
完整认证、签名、数据约定与错误响应。每次重试均须重新生成时间戳、nonce 与签名。
GET /recipient/requirements 返回 details 各字段的必填性与格式约束,用于动态渲染表单。
请求头
string
必填
Bearer API Key。
string
必填
Unix 秒,允许与服务端相差最多 5 分钟。
string
必填
每次请求唯一的随机串,16–64 字符。
string
必填
HMAC-SHA256 签名,小写十六进制;签名必须对应实际发送的请求体。
请求参数
string
10 位数字;商户 App 不传,服务商 App 传值指定作用商户
string
必填
stablecoin_address 或 fiat_accountstring
type=
fiat_account 时必传响应
object
必填
字段规则对象
string
必填
收款人类型
string
规则适用的法币币种
array
必填
字段规则列表
string
必填
details 字段名
boolean
必填
是否必填
string
必填
string 或 integer
integer
最大长度
string
正则约束
string
必填
字段说明
string
示例值
状态与错误
404 币种不支持。curl --request GET \
--url "https://api.stablepay.co/api/v1/recipient/requirements?type=<TYPE>" \
--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/requirements?type=<TYPE>", {
method: "GET",
headers: {
"Authorization": "Bearer <API_KEY>",
"X-StablePay-Timestamp": "<TIMESTAMP>",
"X-StablePay-Nonce": "<NONCE>",
"X-StablePay-Signature": "<SIGNATURE>"
}
});
console.log(await response.json());
{
"recipient_requirements": {
"type": "fiat_account",
"currency": "USD",
"fields": [
{
"field": "account_holder_name",
"required": true,
"type": "string",
"max_length": 140,
"description": "Account holder name",
"example": "John Smith"
},
{
"field": "account_number",
"required": true,
"type": "string",
"pattern": "^[0-9]{6,17}$",
"description": "Local account number",
"example": "012345678901"
}
]
}
}
最后修改于 2026年10月29日
此页面对您有帮助吗?
