台湾地区

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

限额

交易类型	限额
代收	美元：0.99-499.99, 台币：100-20000

金额小数位： TWD — 0位小数（仅整数） | USD — 2位小数

简要描述：

URL： 新台币: /twd/collect/apply 说明：appId需使用新台币对应的，用户支付成功后增加新台币余额美元: /usd/collect/apply 说明：appId需使用美元对应的，用户支付成功后增加美元余额 参数：

参数名	必选	类型	说明
appId	是	Long	业务ID（后台获取，需要根据URL中的币种传递对应的业务ID）
orderId	是	String	商户订单号(必须保证唯一性，长度不超过48)
name	是	String	用户姓名，推荐使用真实姓名，格式：包含firstName和lastName，以空格分割的，示例：John Doe
phone	是	String	真实手机号
email	是	String	真实电子邮件
amount	是	String	交易金额，台币下单不能包含小数
payType	是	String	交易类型
inBankCode	是	String	支付方式
callBackUrl	是	String	用户支付成功后跳转地址
callBackFailUrl	是	String	用户支付失败后跳转地址
notifyUrl	否	String	回调地址
subject	是	String	支付备注
body	否	String	备注详情
country	否	String	收银台模式需要传递，固定值：158
currency	否	String	币种(默认TWD 支持下单币种: USD,TWD)
partnerUserId	是	String	用户唯一标识（如用户ID userId），用于风控系统，必须真实有效，否则会影响交易。格式要求：数字、大小写字母或常用符号-~!@#$%&*()_。
sign	是	String	签名

返回data参数说明

简要描述：

URL： 台币: /twd/collect/query 美元: /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失败（终态）,4部分收款（终态），5超额收款（终态）, -1异常待确认)
payTime	String	支付成功时间（当status=2，4，5时有值）(本地时间), 格式: yyyy-MM-dd HH:mm:ss
errorMsg	String	支付失败原因（当status=3时有值）
sign	String	签名

币种	支付类型(payType)	支付编码(inBankCode)	限额	状态	说明
TWD	QR	JKO_PAY_QR	30-20000	可用	JkoPay QR
TWD	EWALLET	JKO_PAY_TWD	30-20000	可用	JkoPay
TWD	BANK_TRANSFER	ATM	1000-20000	可用	ATM收银台
TWD	BANK_TRANSFER	STORE_IBON	100-20000	可用	7-11超商
TWD	BANK_TRANSFER	STORE_HILIFEET	100-20000	可用	萊爾富Life-ET
TWD	BANK_TRANSFER	STORE_OKGO	100-20000	可用	OK超商OK-go
TWD	BANK_TRANSFER	STORE_FAMI	100-20000	可用	全家FAMIPORT
TWD	BANK_TRANSFER	STORE_MBC_HILIFEET	100-20000	可用	超商行動掃碼(萊爾富Life-ET)
TWD	BANK_TRANSFER	STORE_MBC_IBON	100-20000	可用	7-11超商行動掃碼
USD	EWALLET	JKO_PAY	0.99-499.99	可用	JkoPay
USD	BANK_TRANSFER	LINE_PAY_USD	2.99-499.99	可用	LinePay
USD	BANK_TRANSFER	ATM_USD	32.99-499.99	可用	ATM收银台
USD	BANK_TRANSFER	STORE_IBON_USD	2.99-499.99	可用	7-11超商
USD	BANK_TRANSFER	STORE_HILIFEET_USD	2.99-499.99	可用	萊爾富Life-ET
USD	BANK_TRANSFER	STORE_OKGO_USD	2.99-499.99	可用	OK超商OK-go
USD	BANK_TRANSFER	STORE_FAMI_USD	2.99-499.99	可用	全家FAMIPORT
USD	BANK_TRANSFER	STORE_MBC_HILIFEET_USD	2.99-499.99	可用	超商行動掃碼(萊爾富Life-ET)
USD	BANK_TRANSFER	STORE_MBC_IBON_USD	2.99-499.99	可用	超商行動掃碼(7-11)