接口规则
数据提交和接收的方式
注意:如贵司需验证SSL证书,在绑定证书公钥后请发送商户编号、公司名称、联系方式至tech-support@Geoswift.com报备,如未报备(单向认证),出现损失由贵司自行承担
Geoswift所有的数据提交和接收的方式皆是以post方式提交和接收,并且数据皆以aes加密(请求json)后的格式来提交到接口和接收异步回调,我们的异步回调是以流的方式返回的(aes加密后格式)。
请求头:ContentType = “application/vnd.Geoswift-v3.0+json”;
异步通知说明
- 当贵公司系统收到Geoswift的订单终态的数据通知(服务
器点对点通讯形式)时,必须输出“SUCCESS”Geoswift收到 “SUCCESS”,便认为贵公
司已收到;否则将继续发送通知,以递增的时间间隔再次重发 4 次;时间间隔分别为 20/30/40/50秒,总时长 140 秒,以确保订单通知成功,(重复多次收到异步通知信息,一定要做好订单状态判断,不要重复入账)。
- 异步回调为通知行为,商户收到通知后应按照要求返回,不支持重定向。
- 下单同步返回的status仅仅代表订单提交状态,不可以作为订单状态的判断。订单状态以订单的异步返回和查询接口返回为准。
参数填充注意事项
- 订单号requestId是用户请求的唯一标识,请不要重复使用一个requestId。
- notifyUrl,callbackUrl请上传一个格式正确的可外网访问的在您报备主域名下的url网址,不要传IP(修改报备域名,请联系商务经理),callbackUrl商户如果不需要可以保持和notifyUrl相同即可。
- clientIP要传客户端外网IP,保证下单IP与支付IP一致。(由于运营商网络等原因可能会有出入IP不一致的问题,可以通过切换网络(4G、wifi)进行重试)。
- 订单的跳转的域名要在报备的主域名下。
其他注意事项
- 如贵司需验证 SSL 证书,在绑定证书公钥后请发送商户编号、公司名称、联系方式至tech-support@geoswift.com 报备;
- 如未报备(单向认证),出现损失由贵司自行承担。