本接口作用是能够不通过商户后台直接通过 api 发起跨境汇款,商户可将此接口集成到商户自身运营后台上,以便运营人员直接发起。
https://apis.5upay.com/transfer/order
参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
---|---|---|---|---|
merchantId | 商户编号 | varchar(20) | 商户编号 | M |
requestId | 订单号 | varchar(50) | 提交的订单号必须在自身账户交易中唯一;首信易支付系统中对于已付或者撤销的订单,商户端不能那个重复提交。 | M |
amount | 汇款金额 | decimal(18) | 单位:分,1 元=100 分 | M |
currency | 汇单金额币种 | varchar(15) | CNY(人民币)、USD(美元)、JPY(日元)、EUR(欧元)、CHF(瑞士法郎)GBP(英镑)、CAD(加拿大元)、AUD(澳大利亚元)、HKD(港币) | M |
creditedCurrency | 预计到账币种 | varchar(15) | CNY(人民币)、USD(美元)、JPY(日元)、EUR(欧元)、CHF(瑞士法郎)、GBP(英镑)、CAD(加拿大元)、AUD(澳大利亚元)、HKD(港币) | M |
transferMode | 汇款类型 | varchar | DETAIL 明细汇款 | M |
transferBusinessType | 业务类型 | 固定值 | STUDYABROAD 留学 | M |
GOODSTRADE 货物贸 | ||||
PLANETICKET 机票 | ||||
HOTELACCOMMODATION 酒店住宿 | ||||
SOFTWARE 软件 | ||||
TRAVEL 旅游 | ||||
LOGISTICS 物流 | ||||
OTHER 其它 | ||||
singleReceiveAccount | 是否单账户 | varchar | true:是 false:否 | M |
isMerger | 是否合并 | varchar | true:是 false:否 | M |
detailPath | 上传明细地址 | varchar(200) | 文件模板请见交易明细模板.xlsx, 明细文件需要上传到 ftp | M |
listpriceToken | 锁定牌价标识 | varchar(32) | 见锁定牌价接口的锁定牌价标识,如不传则获取实时牌价 | O |
notifyUrl | 通知地址 | varchar(200) | 支付成功后首信易支付会向该地址发送五次成功通知,该地址可以带参数,“www.5upay.com/callback.action?test=test”注意:如不填 notifyUr的参数值订单成功后您的服务器将得不到成功的通知。 | M |
payee | 汇款信息 | JSON | 见下表,汇款信息 | C |
validateId | 校验号 | varchar(200) | 调用数据校验接口返回的参数,在发起大批量(500 条以上)的明细汇款时需使用此参数 | O |
hmac | 参数签名 | varchar(500) | 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 | M |
注:如果是单账户,需要填写收款账户
参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
---|---|---|---|---|
recName | 收款方姓名 | varchar(50) | 收款方姓名 | M |
accountNumber | 收款方账号 | varchar(50) | 收款方账号 | M |
recAddress | 收款方地址 | varchar(200) | 收款方地址 | C |
countryCode | 收款方常驻国家代码 | varchar(3) | 见国家列表 | M |
ibanCode | IBAN | varchar | IBAN | O |
bankName | 收款行名称 | varchar | 收款行名称 | M |
swiftCode | 收款行 SWIFT | varchar | 收款行 SWIFT 和收款行地址不能同时为空 | C |
routingCode | Routing Number | varchar | Routing Numbe | O |
bsbCode | BSB Number | varchar | BSB Number | O |
bankAddress | 收款行地址 | varchar | 收款行 SWIFT 和收款行地址不能同时为空 | C |
postScript | 汇款附言 | varchar(140) | 汇款附言 | O |
proxyBankAccountNumber | 收款行在其代理行账号 | varchar | 收款行在其代理行账号 | O |
proxyBankName | 收款行之代理行名称 | varchar | 收款行之代理行名称 | O |
proxySwiftCode | 收款行之代理行SWIFT | varchar | 收款行之代理行 SWIFT | O |
proxyBankAddress | 收款行之代理行地址 | varchar | 收款行之代理行地址 | O |
参数名称 | 参数中文名称 | 参数说明 |
---|---|---|
merchantId | 商户编号 | 商户在首信易系统的唯一身份标识,商户完成首信易系统注册后可登录商户后台商户服务查看。 |
requestId | 订单号 | 订单号为商户自行拟定,提交的订单号必须在自身平台交易中唯一。首信易支付系统已付或撤销的订单,商户平台不能以相同的订单号再次提交。 |
status | 请求状态 | 成功 SUCCESS,请求已接收 |
失败 FAILE | ||
错误 ERRO | ||
hmac | 参数签名 | 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 |
参数名称 | 参数中文名称 | 参数说明 |
---|---|---|
merchantId | 商户编号 | 商户编号 |
requestId | 订单号 | 提交的订单号必须在自身账户交易中唯一;首信易支付系统中对于已付或者撤销的订单,商户端不能那个重复提交。 |
serialNumber | 交易流水号 | 首信易系统交易流水号 |
currency | 汇单金额币种 | CNY(人民币)、USD(美元)、JPY(日元)、EUR(欧元)、CHF(瑞士法郎)GBP(英镑)、CAD(加拿大元)、AUD(澳大利亚元)、HKD(港币) |
amount | 支付金额 | 单位:分,1 元=100 |
status | 汇款状态 | SUCCESS 提交成功 |
CANCEL 提交失败 | ||
completeDataTime | 创建时间 | 汇款完成时间 |
foexignExchangeResponse | 购汇返回参数 | 见下表,购汇返回参数 |
hmac | 参数签名 | 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 |
参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 |
---|---|---|---|
amount | 购汇金额 | decimal(18) | 单位:分,1 元=100 分 |
currency | 购汇币种 | varchar(15) | CNY(人民币)、USD(美元)、JPY(日元)、EUR(欧元)、CHF(瑞士法郎)GBP(英镑)、CAD(加拿大元)、AUD(澳大利亚元)、HKD(港币) |
status | 购汇状态 | varchar(10) | SUCCESS 提交成功 |
CANCEL 提交失败 | |||
listprice | 牌价标识 | varchar(32) | 牌价标识 |
deductionAmount | 购汇扣减额 | decimal(18) | 购汇扣除的人民币金额 |
completeDataTime | 购汇时间 | varchar(20) | 购汇完成时间 |