跳转到主要内容
阅读该接口文档前,务必先查看 接口说明

限额

交易类型限额
代收美元: 1-3000, 新加坡元: 1-3000

代收API

代收申请

简要描述:
  • 创建代收订单
URL: 新加坡元: /sgd/collect/apply 说明:appId需使用新加坡元对应的,用户支付成功后增加新加坡元余额 美元: /usd/collect/apply 说明:appId需使用美元对应的,用户支付成功后增加美元余额 港元: /hkd/collect/apply 说明:appId需使用港元对应的,用户支付成功后增加港元余额 参数:
参数名必选类型说明
appIdLong业务ID(后台获取,需要根据URL中的币种传递对应的业务ID)
orderIdString商户订单号(必须保证唯一性,长度不超过48)
nameString用户姓名,推荐使用真实姓名,格式:包含firstName和lastName,以空格分割的,示例:Donald John Trump
phoneString真实手机号(格式参考 电话号码格式
emailString真实电子邮件
amountString交易金额,最多两位小数
payTypeString交易类型
inBankCodeString支付方式
callBackUrlString用户支付成功后跳转地址
callBackFailUrlString用户支付失败后跳转地址
notifyUrlString回调地址
subjectString支付备注
bodyString备注详情
partnerUserIdString用户唯一标识(如用户ID userId),用于风控系统,必须真实有效,否则会影响交易。 格式要求:数字、大小写字母或常用符号-~!@#$%&*()_。
signString签名
返回data参数说明
参数名类型说明
orderIdString商户订单号(必须保证唯一性)
orderNoString平台订单号
payUrlString支付链接
signString签名

代收查询

简要描述:
  • 查询代收订单
URL: 新加坡元: /sgd/collect/query 美元: /usd/collect/query 港币: /hkd/collect/query 参数:
参数名必选类型说明
appIdLong业务ID(后台获取,需要根据URL中的币种传递对应的业务ID)
orderIdString商户订单号
orderNoString平台订单号(响应快)
signString签名
返回data参数说明
参数名类型说明
orderIdString商户订单号(必须保证唯一性)
orderNoString平台订单号
amountString交易金额
actualAmountString收到金额
feeString手续费
statusInteger状态(0未开始,1支付中,2成功(终态),3失败(终态), -1异常待确认)
payTimeString支付成功时间(当status=2时有值)(币种时间), 格式: yyyy-MM-dd HH:mm:ss
errorMsgString支付失败原因(当status=3时有值)
signString签名

支付方式

币种支付类型(payType)支付编码(inBankCode)限额状态说明
SGDEWALLETPAYNOW_SGD1-3000可用PayNow扫码支付
USDBANK_TRANSFERPAYNOW_USD1-3000可用PayNow扫码支付
Last modified on April 17, 2026