v1

latestOpenAPI 3.1.02026-07-26850209.3 KB

新台币代收申请

appId需使用新台币对应的,用户支付成功后增加新台币余额

post/twd/collect/apply

Request body

appIdinteger required

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

orderIdstring required

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

namestring required

用户姓名,推荐使用真实姓名,格式:包含firstName和lastName,以空格分割的,示例:John Doe

phonestring required

真实手机号

emailstring email required

真实电子邮件

amountstring required

交易金额,台币下单不能包含小数

payTypestring required

交易类型

inBankCodestring required

支付方式

callBackUrlstring uri required

用户支付成功后跳转地址

callBackFailUrlstring uri required

用户支付失败后跳转地址

notifyUrlstring uri

回调地址

subjectstring required

支付备注

bodystring

备注详情

countrystring

收银台模式需要传递,固定值:158

currency'USD' | 'TWD'

币种(默认TWD 支持下单币种: USD,TWD)

partnerUserIdstring required

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

signstring required

签名

Response

statusstring

状态码

errorstring

错误码

msgstring

返回信息