curl --request GET \
--url "https://api.stablepay.co/api/v1/transfer/{transfer_id}" \
--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/transfer/{transfer_id}", {
method: "GET",
headers: {
"Authorization": "Bearer <API_KEY>",
"X-StablePay-Timestamp": "<TIMESTAMP>",
"X-StablePay-Nonce": "<NONCE>",
"X-StablePay-Signature": "<SIGNATURE>"
}
});
console.log(await response.json());
{
"transfer_id": "9000000011",
"merchant_id": "2000000001",
"transfer_type": "on_ramp",
"quote_id": "9000000017",
"fiat_deposit_id": "9000000090",
"source_amount": 100500,
"target_amount": 100479,
"rate_type": "fixed",
"rate": "0.9998",
"fee_amount": 5,
"fee_currency": "USD",
"target_account_no": "00000001",
"status": "processing",
"created": 1718726400
}
稳定币兑换 API
查询转账
查询转账
GET
/
api
/
v1
/
transfer
/
{transfer_id}
curl --request GET \
--url "https://api.stablepay.co/api/v1/transfer/{transfer_id}" \
--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/transfer/{transfer_id}", {
method: "GET",
headers: {
"Authorization": "Bearer <API_KEY>",
"X-StablePay-Timestamp": "<TIMESTAMP>",
"X-StablePay-Nonce": "<NONCE>",
"X-StablePay-Signature": "<SIGNATURE>"
}
});
console.log(await response.json());
{
"transfer_id": "9000000011",
"merchant_id": "2000000001",
"transfer_type": "on_ramp",
"quote_id": "9000000017",
"fiat_deposit_id": "9000000090",
"source_amount": 100500,
"target_amount": 100479,
"rate_type": "fixed",
"rate": "0.9998",
"fee_amount": 5,
"fee_currency": "USD",
"target_account_no": "00000001",
"status": "processing",
"created": 1718726400
}
完整认证、签名、数据约定与错误响应。每次重试均须重新生成时间戳、nonce 与签名。
GET /transfer/{transfer_id} 按转账 ID 或业务参考号返回转账详情与状态。
请求头
string
必填
Bearer API Key。
string
必填
Unix 秒，允许与服务端相差最多 5 分钟。
string
必填
每次请求唯一的随机串，16–64 字符。
string
必填
HMAC-SHA256 签名，小写十六进制；签名必须对应实际发送的请求体。
请求参数
string
必填
转账 ID，10 位数字
string
10 位数字；商户 App 不传，服务商 App 传值指定作用商户
string
按业务参考号查询
响应
string
必填
转账 ID，10 位数字
string
必填
商户 ID
string
业务参考号
string
必填
on_ramp、off_ramp、swapstring
执行的报价 ID
string
on_ramp 的充值记录string
卖出币种
string
买入币种
string
卖出网络
string
买入网络
integer
卖出金额，不含费用
integer
买入金额；floating 下为估算
string
fixed 或 floating
string
汇率，十进制字符串
integer
手续费
string
费用币种
string
转出账户
string
入账账户
string
收款人 ID
object
地址与 memo 或银行字段
string
必填
processing、
payment_submitted、completed、funds_refunded、bounced_backstring
失败原因
object
自定义元数据
integer
必填
创建时间
integer
最近更新时间
状态与错误
404 转账不存在或不属于目标商户。 状态机：processing（处理中）→payment_submitted（资金链路已发出）→ completed（完成）；终态还包括 funds_refunded（退回）与 bounced_back（拒收退回），失败原因写在 failure_reason。状态变化通过 Webhook 推送 transfer.* 事件，也可通过转账查询接口轮询。
curl --request GET \
--url "https://api.stablepay.co/api/v1/transfer/{transfer_id}" \
--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/transfer/{transfer_id}", {
method: "GET",
headers: {
"Authorization": "Bearer <API_KEY>",
"X-StablePay-Timestamp": "<TIMESTAMP>",
"X-StablePay-Nonce": "<NONCE>",
"X-StablePay-Signature": "<SIGNATURE>"
}
});
console.log(await response.json());
{
"transfer_id": "9000000011",
"merchant_id": "2000000001",
"transfer_type": "on_ramp",
"quote_id": "9000000017",
"fiat_deposit_id": "9000000090",
"source_amount": 100500,
"target_amount": 100479,
"rate_type": "fixed",
"rate": "0.9998",
"fee_amount": 5,
"fee_currency": "USD",
"target_account_no": "00000001",
"status": "processing",
"created": 1718726400
}
最后修改于 2026年10月29日
此页面对您有帮助吗？