签名算法说明
易支付采用MD5签名机制确保接口安全。签名格式为:sign=md5(md5(api_key)+timestamp),其中timestamp为Unix时间戳。这种双重MD5加密方式能有效防止请求被篡改。商户在调用接口时,需要先将自己的api_key进行MD5加密,然后与时间戳拼接后再次进行MD5运算,生成最终的签名sign。服务器端会验证签名的有效性,签名超时时间通常为15分钟。
接口地址与请求格式
易支付API地址为 https://pay.mqsq.cn/api.php,请求方式支持POST和GET两种。请求参数需要包含:merchant_id(商户号)、timestamp(时间戳)、sign(签名)、amount(金额)、out_trade_no(商户订单号)等。推荐使用POST方式提交敏感参数,避免参数在日志中泄露。接口返回格式为JSON,便于服务端解析处理。
回调通知处理
支付完成后,易支付服务器会异步回调notify_url指定的地址。商户需要验证签名、检查订单状态并返回success字符串表示已处理。回调地址必须可公网访问,建议使用HTTPS。回调超时时间一般为30秒,如果商户服务器处理时间较长,建议先返回success再异步处理业务逻辑,避免因超时导致重复回调。
订单查询与退款
通过查询接口可以实时获取订单状态,支持部分退款和全额退款。退款申请需要提供原商户订单号和退款金额,系统会在1-3个工作日内处理完成。订单查询接口可以获取订单的最新状态,包括待支付、已支付、已退款、已关闭等状态。退款时需要注意,退款金额不能超过原订单支付金额,且每笔订单只能退款一次。
技术支持与文档更新
易支付提供7x24小时技术支持服务,商户遇到接入问题可随时咨询。API文档定期更新,建议开发者关注最新接口规范以获取最佳体验。平台还提供多种编程语言的SDK示例,包括PHP、Java、Python、Go等主流语言,开发者可以直接集成使用。沙箱环境可供测试,测试数据与正式数据完全隔离,确保测试过程不会影响正式运营。
通过本文的介绍,相信开发者已经对易支付API有了全面的了解。建议从沙箱环境开始测试,确保集成无误后再切换到正式环境。如有任何技术问题,可随时联系易支付技术支持团队,获取专业的技术指导和服务支持。