curl --request POST \
--url "https://api.stablepay.co/api/v1/transfer" \
--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 '{
"transfer_type": "on_ramp",
"fiat_deposit_id": "9000000090",
"amount": 100500,
"target_currency": "USDC",
"target_network": "solana",
"rate_type": "fixed"
}'
const response = await fetch("https://api.stablepay.co/api/v1/transfer", {
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({
"transfer_type": "on_ramp",
"fiat_deposit_id": "9000000090",
"amount": 100500,
"target_currency": "USDC",
"target_network": "solana",
"rate_type": "fixed"
})
});
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
创建转账(法币兑换稳定币、稳定币兑换法币、稳定币互换)
创建转账(法币兑换稳定币、稳定币兑换法币、稳定币互换)
POST
/
api
/
v1
/
transfer
curl --request POST \
--url "https://api.stablepay.co/api/v1/transfer" \
--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 '{
"transfer_type": "on_ramp",
"fiat_deposit_id": "9000000090",
"amount": 100500,
"target_currency": "USDC",
"target_network": "solana",
"rate_type": "fixed"
}'
const response = await fetch("https://api.stablepay.co/api/v1/transfer", {
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({
"transfer_type": "on_ramp",
"fiat_deposit_id": "9000000090",
"amount": 100500,
"target_currency": "USDC",
"target_network": "solana",
"rate_type": "fixed"
})
});
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 与签名。
POST /transfer 一次兑换执行:on_ramp 法币换稳定币、off_ramp 稳定币换法币、swap 稳定币互换。
请求头
string
必填
Bearer API Key。
string
必填
Unix 秒,允许与服务端相差最多 5 分钟。
string
必填
每次请求唯一的随机串,16–64 字符。
string
必填
HMAC-SHA256 签名,小写十六进制;签名必须对应实际发送的请求体。
string
幂等键
请求参数
string
引用报价时须与报价商户一致
string
必填
on_ramp、off_ramp、swapinteger
必填
卖出金额;
on_ramp 须等于充值记录金额string
业务参考号
string
引用的报价,与
rate_type 互斥string
fixed 锁汇、floating 浮动
string
on_ramp 必传,充值记录 IDstring
swap 与
off_ramp 的卖出币种string
卖出网络
string
swap 与
off_ramp 必传string
买入币种
string
买入网络
string
on_ramp 入账账户string
off_ramp 必传;on_ramp 与 swap 可选object
自定义元数据
响应
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
最近更新时间
状态与错误
400 参数不合法;404 报价或充值记录不存在;409 报价已用或过期、余额不足。curl --request POST \
--url "https://api.stablepay.co/api/v1/transfer" \
--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 '{
"transfer_type": "on_ramp",
"fiat_deposit_id": "9000000090",
"amount": 100500,
"target_currency": "USDC",
"target_network": "solana",
"rate_type": "fixed"
}'
const response = await fetch("https://api.stablepay.co/api/v1/transfer", {
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({
"transfer_type": "on_ramp",
"fiat_deposit_id": "9000000090",
"amount": 100500,
"target_currency": "USDC",
"target_network": "solana",
"rate_type": "fixed"
})
});
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日
此页面对您有帮助吗?
