注意

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

警告

以下地区禁止使用！！！

禁用地区列表

埃塞俄比亚

索马里

科特迪瓦

喀麦隆

巴布亚新几内亚

瑞典

马达加斯加

赞比亚

贝宁

古巴

波斯尼亚和黑塞哥维那

塞尔维亚

多米尼加共和国

几内亚

安哥拉

塞拉利昂

塔吉克斯坦

尼日尔

毛里塔尼亚

毛里求斯

乍得

阿拉伯联合酋长国

吉布提

吉尔吉斯斯坦

乌兹别克斯坦

伊朗伊斯兰共和国

冈比亚

孟加拉国

乌拉圭

马拉维

黎巴嫩

北马其顿

泽西岛

土库曼斯坦

格陵兰

厄瓜多尔

法属波利尼西亚

南非

俄罗斯联邦

苏里南

圭亚那

法属圭亚那

朝鲜

柬埔寨

缅甸

老挝

利比亚

苏丹

刚果（金）

印度

马来西亚

菲律宾

泰国

越南

印度尼西亚

巴基斯坦

斯里兰卡

尼泊尔

马尔代夫

不丹

阿富汗

哈萨克斯坦

土库曼斯坦

吉尔吉斯斯坦

塔吉克斯坦

限额

交易类型	限额(单位:USD)
代收	0.99-1000

代收API

代收申请

简要描述：

• 创建代收订单

URL：

美元: /usd/collect/apply

参数：

参数名	必选	类型	说明
appId	是	Long	业务ID（后台获取，需要根据URL中的币种传递对应的业务ID）
orderId	是	String	商户订单号(必须保证唯一性，长度不超过48)
name	是	String	用户姓名，推荐使用真实姓名，格式：包含firstName和lastName，以空格分割的，示例：Donald John Trump
phone	是	String	真实手机号（格式参考 电话号码格式 ）
email	是	String	真实电子邮件
amount	是	String	交易金额（精确到小数点后两位；禁止添加标点符号，例如：”,”）
payType	是	String	EWALLET
inBankCode	是	String	APPLE_PAY
callBackUrl	是	String	支付完成后跳转地址
notifyUrl	否	String	回调地址
subject	是	String	支付备注
body	否	String	备注详情
partnerUserId	是	String	用户唯一标识（如用户ID userId），用于风控系统，必须真实有效，否则会影响交易。 格式要求：数字、大小写字母或常用符号-~!@#$%&*()_。
sign	是	String	签名

返回data参数说明

参数名	类型	说明
orderId	String	商户订单号(必须保证唯一性)
orderNo	String	平台订单号
payUrl	String	支付链接
sign	String	签名

代收查询

简要描述：

• 查询代收订单

URL：

美元: /usd/collect/query

参数：

参数名	必选	类型	说明
appId	是	Long	业务ID（后台获取，需要根据URL中的币种传递对应的业务ID）
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	签名