全球收银台支付接口

1008字约3分钟

注意

阅读该接口文档前，务必先查看 接口说明

如有需要，可联系将所有的业务密钥配置信息改为同一套

代收API

简要描述：

URL：

/global/cashier/collect/apply 说明：appId 收银台， amount与currency对应，实收结算也是与currency对应

参数：

参数名	必选	类型	说明
appId	是	Long	业务ID（后台获取，请使用收银台专属APPID，币种为收银台(CASHIER)）
orderId	是	String	商户订单号(必须保证唯一性，长度不超过48)
name	是	String	用户姓名，推荐使用真实姓名，格式：包含firstName和lastName，以空格分割的，示例：Donald John Trump
email	是	String	真实电子邮件
amount	是	String	交易金额（精确到小数点后两位；禁止添加标点符号，例如：”,”）
currency	是	String	交易金额对应的币种，支持：USD（0.99美元起步），其他币种参考地区编码
callBackUrl	是	String	支付完成后跳转地址，不是支付成功回调通知地址
notifyUrl	否	String	回调地址
subject	是	String	支付备注（交易标题，商品名称，支付原因等）
body	否	String	备注详情
region	是	String	地区编码，使用两位编码即可
partnerUserId	是	String	用户唯一标识（如用户ID userId），用于风控系统，必须真实有效，否则会影响交易。格式要求：数字、大小写字母或常用符号-~!@#$%&*()_。
sign	是	String	签名

返回data参数说明

简要描述：

URL：

/global/cashier/collect/query

参数：

参数名	必选	类型	说明
appId	是	Long	业务ID（后台获取，请使用收银台专属APPID，币种为收银台(CASHIER)）
orderId	是	String	商户订单号
orderNo	是	String	平台订单号
sign	是	String	签名

返回data参数说明

参数名	类型	说明
orderId	String	商户订单号
orderNo	String	平台订单号
amount	String	订单金额
actualAmount	String	实收金额
fee	String	手续费
status	Integer	状态(0未开始，1支付中，2成功（终态），3失败（终态）, -1异常待确认)
payTime	String	支付成功时间（当status=2时有值）(本地时间), 格式: yyyy-MM-dd HH:mm:ss
errorMsg	String	支付失败原因（当status=3时有值）
sign	String	签名

简要描述：

URL：

/global/cashier/collect/query/v2

参数：

参数名	必选	类型	说明
appId	是	Long	业务ID（后台获取，请使用收银台专属APPID，币种为收银台(CASHIER)）
orderId	是	String	商户订单号
orderNo	是	String	平台订单号
sign	是	String	签名

返回data参数说明

参数名	类型	说明
orderId	String	商户订单号
orderNo	String	平台订单号
currency	String	币种(选择具体支付方式后有值)
amount	String	订单金额
actualAmount	String	实收金额
fee	String	手续费
status	Integer	状态(0未开始，1支付中，2成功（终态），3失败（终态）, -1异常待确认)
payTime	String	支付成功时间（当status=2时有值）(本地时间), 格式: yyyy-MM-dd HH:mm:ss
errorMsg	String	支付失败原因（当status=3时有值）
originalCurrency	String	实际支付币种
floatExchangeRate	String	币种转换涉及的汇率
originalAmount	String	实际支付金额
sign	String	签名