跳转到主要内容
POST
卡塔尔里亚尔代收申请

密钥私钥(生成签名)

相关主题

请求体

application/json
appId
integer
必填

业务ID(后台获取,需要根据URL中的币种传递对应的业务ID)

orderId
string
必填

商户订单号(必须保证唯一性,长度不超过48)

Maximum string length: 48
name
string
必填

收款人姓名,用于风险控制

phone
string
必填

真实手机号(格式参考 电话号码格式 )

email
string<email>
必填

真实电子邮件

amount
string
必填

交易金额(单位:本币,精确到小数点后两位;禁止添加标点符号,例如:","),测试环境请使用10SAR以下的金额

Pattern: ^\d+\.\d{2}$
payType
string
必填

交易类型

inBankCode
string
必填

支付方式

callBackUrl
string<uri>
必填

用户支付成功后跳转地址

callBackFailUrl
string<uri>
必填

用户支付失败后跳转地址

goodsName
string
必填

商品名称

goodsQuantity
string
必填

商品数量

goodsPrice
string
必填

商品单价

Pattern: ^\d+\.\d{2}$
goodsSku
string
必填

商品唯一标识

goodsAvatar
string<uri>
必填

商品图(https://)

platform
string
必填

平台名称

partnerUserId
string
必填

用户唯一标识(如用户ID userId),用于风控系统,必须真实有效,否则会影响交易。 格式要求:数字、大小写字母或常用符号-~!@#$%&*()_。

Pattern: ^[A-Za-z0-9\-~!@#$%&*()_]+$
sign
string
必填

签名

currency
string

币种(USD,本币)

cancelUrl
string<uri>

用户取消支付URL,如果传递,用户可在支付页面点击返回到此页面

notifyUrl
string<uri>

回调地址

subject
string

支付备注

body
string

备注详情

响应

200 - application/json
status
string

状态码

error
string

错误码

msg
string

返回信息

data
object
最后修改于 2026年7月16日