易支付API下单接口，是商户系统向支付平台提交订单、获取支付入口的接口。常见易支付兼容系统使用 /submit.php 进行页面跳转下单，使用 /mapi.php 进行API下单。但不同服务商和程序版本可能调整路径、请求方式与返回字段，完整地址要以实际开通平台的接口文档为准。

文档里同时出现submit.php和mapi.php，调用哪个

搜索“易支付接口地址”时，经常能看到这两个路径：

https://example.com/submit.php

https://example.com/mapi.php

这里的域名只是格式示意，接入时换成服务商提供的支付网关域名，不能直接复制使用。

submit.php 常见于网页收银场景。网站组织订单信息并签名后，通过表单等方式把用户带到支付平台，由平台展示收银台或继续跳转支付渠道。

mapi.php 常见于服务端API调用。业务服务器提交订单后，平台返回结构化结果，其中可能包含支付链接或二维码信息，再由网站或应用展示给用户。具体返回什么、怎样发起请求，查对应版本的文档。

如果现有网站只想让用户点击按钮后进入收银台，页面跳转接口可能已经满足需求；如果要在自己的页面展示二维码或控制支付入口，查看API下单接口的返回能力。路径名称相似，也不能直接套用其他平台的请求示例。

下单提示签名错误，核对实际发送的数据

接入时，商户编号用于识别账户，商户订单号用于关联自己的业务订单，金额则由服务端根据订单记录生成。浏览器传来的价格不能直接作为最终支付金额，商户密钥也不要放进前端代码。

签名错误往往发生在“参与计算的数据”和“最终发出的数据”不一致时。商品名称经过编码、金额格式发生变化，都可能导致服务端验签失败。

不少传统易支付兼容接口采用MD5签名：按文档筛选并排序参数，拼接后加入密钥计算摘要。是否排除空值、密钥怎样拼接，都属于协议细节。接入的平台也可能使用其他签名方案，不能凭“易支付”三个字认定算法。

定位时，记录脱敏后的请求参数和参与签名的原文，对照平台示例核对差异；密钥不写入日志。如果接口已经返回支付链接，也只是完成了下单受理，订单此时仍处于待支付状态。

用户已经付款，网站订单还停在待支付

付款后的订单更新，涉及浏览器返回页面和服务器异步通知。常见字段中，return_url 用于用户付款后返回网站，notify_url 用于平台向业务服务器发送支付结果。用户可能付完款就关闭页面，因此发货或开通服务不能依赖页面跳转。

例如，假设一个网站已经能正常生成支付二维码，用户付款后，平台后台显示成功，网站订单却没有更新。检查通知记录时，发现回调地址被网站的登录中间件拦截，平台收到的是登录页跳转，业务程序没有收到付款通知。

这条处理线围绕回调入口展开：把通知路由从用户登录校验中分离，同时保留支付验签；处理通知时，核对商户订单号、金额和支付状态，再更新订单。同一笔通知可能重复到达，已完成的订单不能再次发货。

通知处理完成后，按平台文档返回约定的应答内容。已经漏掉的通知能否补发，还要查看服务商提供的能力；未恢复的订单通过官方查询接口或商户后台逐笔核对，不凭用户返回的页面直接补单。

接入前，确认网关域名对应的接口文档和签名版本。联调时，把“成功创建订单”和“付款后收到并处理有效通知”分开验证，保留脱敏日志，核对订单状态更新结果。