开通收款账号
POST
为付款人开通专属收款 CLABE。开通需要几分钟。请在付款人注册或绑定时调用，不要等到付款时再开户。
本接口幂等。同一 payerId 重复调用，返回同一个收款账号的当前状态，不会重复开户。不需要 Idempotency-Key。
开户不需要付款人 KYC。KYC 在下单时提交。
本期不推送开户结果通知。请用查询收款账号接口查询，建议间隔 1 分钟以上。
收款账号长期有效。同一付款人以后的订单都使用这个 CLABE。
bearerAuthheader
鉴权Bearer <令牌>通过 POST /oauth2/token 获取的 access_token。请求头格式为 Authorization: Bearer {accessToken}。商户身份从 Token 解析，请求体不接受商户或租户字段。
application/json- body
payerId*string商户侧付款人唯一标识。由商户生成，1～64 位，只允许字母、数字、_、-。不得使用邮箱、手机号、证件号等个人信息
匹配
^[A-Za-z0-9_-]{1,64}$fiatCurrency*"MXN"固定 MXN
可选值
"MXN"返回收款账号的当前状态。
application/json- response
code?integer业务状态码
message?stringtraceId?string请求追踪 ID。联系技术支持时请提供
data?付款人收款账号。开通收款账号和查询收款账号使用相同结构。
curl -X POST 'https://api.test.stabofx.com/openapi/v1/collections/on-ramp/receive-accounts' \ -H 'Content-Type: application/json' \ -d '{ "payerId": "payer-0001", "fiatCurrency": "MXN"}'响应示例
{ "code": 200, "message": "OK", "traceId": "trace-uuid-string", "data": { "payerId": "payer-0001", "fiatCurrency": "MXN", "paymentMethod": "SPEI", "status": "PENDING", "clabe": null }}