接口规则

1. 标记栏

在阅读接口文档时，请注意请求参数的最后一栏“是否必填”。

数据提交和接收的方式

注意：如贵司需验证SSL证书,在绑定证书公钥后请发送商户编号、公司名称、联系方式至tech-support@payeasenet.com报备,如未报备(单向认证)，出现损失由贵司自行承担

首信易支付所有的数据提交和接收的方式皆是以post方式提交和接收，并且数据皆以aes加密（请求json）后的格式来提交到接口和接收异步回调，我们的异步回调是以流的方式返回的（aes加密后格式）。

请求头：ContentType = “application/vnd.5upay-v3.0+json”;

异步通知说明

1. 当贵公司系统收到首信易的订单终态的数据通知（服务 器点对点通讯形式）时，必须输出“SUCCESS”首信易收到 “SUCCESS”，便认为贵公 司已收到；否则将继续发送通知，以递增的时间间隔再次重发 4 次；时间间隔分别为 20/30/40/50秒，总时长 140 秒，以确保订单通知成功,（重复多次收到异步通知信息，一定要做好订单状态判断，不要重复入账）。
2. 异步回调为通知行为，商户收到通知后应按照要求返回，不支持重定向。

下单同步返回的status仅仅代表订单提交状态，不可以作为订单状态的判断。订单状态以订单的异步返回和查询接口返回为准。

参数填充注意事项

• 接口中的payer参数，可以为空但是不可以不传（可以传“payer”: {} 或“payer”:{“name”：}注意大括号外没有双引号）。
• productDetails是Json数组，上传格式应为“productDetails”: [{“name”: “XXX “,“quantity”:”1”,”amount”:”1”}]。
• 注意amount（单位：分）和quantity不要出现小数点。
• 订单号requestId是用户请求的唯一标识，请不要重复使用一个requestId。
• notifyUrl，callbackUrl请上传一个格式正确的可外网访问的在您报备主域名下的url网址，不要传IP（修改报备域名，请联系商务经理），callbackUrl商户如果不需要可以保持和notifyUrl相同即可。
• clientIP要传客户端外网IP，保证下单IP与支付IP一致。（由于运营商网络等原因可能会有出入IP不一致的问题，可以通过切换网络（4G、wifi）进行重试）。
• 订单的跳转的域名要在报备的主域名下。