技术对接说明

本文的主要目标读者是需要对接的合作方的技术实施人员。

正式环境

业务名词定义#

单位统一为印尼盾(卢比)，保留整数部分，比如 30000。由于印尼盾单位比较小，交易时只支持整数。

只有订单状态为 SUCCESS 时需要修改订单状态成功，其他状态无需修改订单状态，目前平台暂不支持退款操作，如需退款给客户，建议商户线下处理。

由于印尼市场很多地方不支持中文，所以接口请求参数请避免出现中文以及一些特殊支付，比如表情符号之类。
支付接口中的 name 字段只是在用户支付时显示虚拟账号名称使用，不做校验，一般要求由字母、数字以及空格组成，不超过 30 位。
支付接口中的 email phone 字段只为上游需要，暂时未发现其他作用，并不会给客户发短信、发邮件的;虽然不会验证，但是需要符合格式规范，如手机号必须为纯数字，邮箱格式必须为 [email protected]
当使用 OVO 电子钱包支付时，支付接口中的 phone 字段必须填写客户注册 OVO 电子钱包的手机号，一般形如:082113086611 OVO 是推送消息的模式，下单成功后会往客户手机上的 OVO 电子钱包 app 推送一个付款消息，只要客户点击确认了即可完成付款，OVO 要求客户必须在 30s 内完成付款，过期失效。
支付接口的 expiryPeriod(过期时间)单位是分钟，字段值范围建议保持在 15- 97200 范围内，如果该值不送默认为 4320，也就是3天内有效。

代付接口中的收款账户的银行(bankCode)、帐号(number)和帐号名称(name)必须相互匹配，否则可能导致转账失败，其中账号名(name)可忽略大小写。建议客户绑卡时调用银行账号校验接口，具体见接口 // TODO:
代付接口 feeType 字段解释:
1. 0 指代付手续费从请求的代付交易金额中扣除，比如请求代付金额1000，我方平台需要收取5元手续费，那么代付到账金额为995;
2. 1 从商户余额中扣除，即请求代付金额1000，实际到账1000，商户余额减去1005。

代付请求超时以及返回UNKNOWN系统异常时不能认为订单失败，不要重复发起，此时订单处理结果应该以异步通知结果或代付查询结果为准。

平台回调参数以 form 表单形式提交，收到我方通知后请返回字符串 SUCCESS ,否则我方会每隔一段时间通知一次(一共通知 6 次)。通知的间隔时间依次为 1S、30S、60s、90s、1h、2h

注意：由于网络原因，订单异步通知有可能不会完全按照以上间隔时间通知，并且不排除重复通知的情况，因此要求商户支持重复通知(即已更改状态的订单不再进行操作，直接返回字符串 SUCCESS)。