欢迎使用 Transafe

接口对接可自助完成，无需我们的工作人员介入，如遇到问题，请先仔细阅读文档。

最佳实践（必看）

1. 创建代付订单接口一定要判定HttpCode，如果HttpCode未返回200，必须向我们运营人员询问订单的状态才可以再提交。
2. 代收回调处理，请务必校验真实付款金额
3. 请务必在商户后台的IP白名单中，添加贵方的服务器IP
4. 在回调接口，请将我方的服务器IP加白
5. 对于同一用户同一代收金额，在时间间隔不大的情况，不建议反复请求代收接口。

约定&注意事项（必看）

1. 对接过程中遇到问题，请在群里@技术人员。请求遇到问题，请务必提供如下要素：请求链接、请求参数、响应返回HttpCode、响应返回Body；签名遇到问题，请提供：加签/验签之前字符串、所使用到的环境、收到/生产的签名。
2. 所有的POST请求Content-Type为：application/json;
3. 代收代付的平台回调需返回HTTP-CODE(HTTP 响应状态码)为200, 若未返回, 则在12小时内重试5次, 之后便不再回调
4. 字符编码: 统一采用UTF-8字符编码
5. 数据格式: 提交和返回数据都为JSON格式
6. 签名算法: OPENSSL_ALGO_SHA256（私钥加签，公钥验签）
7. 判断逻辑: 先判断协议字段返回，再判断业务返回，最后判断交易状态
8. 所有的金额: 单位为“元”，数字类型不要带.00或0.20，如100.00❌，100.20❌，100✅，100.2✅
9. 测试环境上支持自动回调，请求参数手机号最后一位单数回调成功，手机号双数回调失败
10. 姓名+手机号+邮箱+金额为判定不同客户发起依据，因此，不建议姓名、手机号、邮箱都写死，建议同一客户使用同一个姓名+手机号+邮箱，否则容易产生风控误判。
11. 所有的接口返回都包含status字段，非200表示失败，失败原因以及提示给用户的信息，建议根据status枚举进行封装，请勿直接给用户展示接口返回的msg字段（可能包含敏感信息）
12. 接口提交的所有数据，严禁出现中文