文档里的 submit.php 和 mapi.php 怎么选

易支付API下单接口，是商户网站向支付平台提交订单、获取支付入口的接口。“易支付”存在不同部署版本，接口地址由所接平台的域名和路径组成，没有所有商户通用的完整网址。

常见兼容实现提供 /submit.php 和 /mapi.php，但并非每个平台都同时支持。

/submit.php 多用于页面跳转支付：网站通过表单提交订单，浏览器进入支付收银台。如果目标是让用户点击“付款”后跳转，这类入口比较直接。

/mapi.php 多用于服务端下单：商城后端提交请求，平台返回支付链接或二维码信息，再由商城页面展示。请求方法、提交格式和返回字段存在版本差异，按当前平台文档处理。不要把页面跳转接口当成JSON接口调用，否则返回的可能是网页内容。

拿到接口地址后，核对它属于当前商户使用的平台，再确认账号已开通对应支付通道。网上搜到的示例域名不能直接替换商户号后使用。

下单请求中的签名怎么生成

订单信息由商城后端生成。金额从服务器保存的商品价格和订单记录中读取，不直接采用浏览器传来的金额；商户密钥也只保存在后端。

不少易支付兼容接口采用MD5签名：排除 sign、sign_type 以及文档规定不参与签名的空值字段，将其余参数按参数名排序，拼接成查询串，再按文档要求追加密钥后计算摘要。这是常见规则，不代表所有版本都相同。

签名失败时，检查参与签名的原始内容与实际发送内容。金额字符串被重新格式化、中文参数编码不同，都可能改变签名结果。密钥前是否加分隔符、字段何时编码，直接依据该平台的签名示例，不凭其他网站的代码推断。

本地订单号在请求发出前保存。接口返回支付链接，只代表下单请求已被接受，订单此时仍处于待支付状态。

买家已付款，商城订单却仍待支付

支付完成后，平台一般通过异步通知地址向商城后端发送结果；浏览器跳回的页面负责展示信息，不能单独作为发货依据。用户可能关闭页面，跳转参数也可能被修改。

假设一个商城已经接通下单接口，买家反馈支付页面显示成功，商城后台却仍显示待支付。此时不要直接把订单改成已支付，处理线索集中在这笔订单的支付记录和回调记录上。

商城用本地订单号向平台查询，查询入口和返回状态按文档核对。如果平台记录为支付成功，而商城没有收到有效通知，就检查通知地址的访问日志。通知可能被登录校验拦截，也可能已经到达，但应用验签后没有接受。买家的截图只作为沟通线索，后台确认依赖可核对的交易记录。

收到通知后，商城核对签名、订单号及金额，确认状态确实表示支付成功，再更新订单。相同订单的通知可能重复到达，发货操作要做幂等处理：已完成的订单再次收到有效通知时，不重复发货，按平台要求返回确认内容。

在这个假设情境中，若查到通知被登录校验拦截，后续动作是为回调路径调整访问规则，同时保留验签校验。查询已确认的支付结果用于补齐订单状态，另一笔测试订单用于验证通知能否正常到达；未确认结果的订单继续保留待核对状态。

实际接入前，向平台确认当前下单入口和签名示例；上线前，把支付通知到达、订单状态更新及重复通知处理测试完整。