娱乐通接口文档：下单与支付指南

"娱乐通接口1.91是用于实现统一下单和扫码下单功能的API，涉及到网络协议，包括统一下单接口和扫码下单接口。统一下单接口需要提供如商户号、订单号、金额、支付通道、银行编码等关键参数，并可选择性设置通知地址和跳转地址。扫码下单接口在某些支付方式下会通过GET方式重定向跳转，无需处理应答参数。接口还涉及到异步通知和错误处理，以及附录中的支付网关和银行编码信息。" 详细说明： 1. **统一下单接口**： - 这个接口允许商户通过向平台网关提交一系列参数来发起支付请求。参数包括`merchant_no`（商户号）、`order_no`（商户订单号）、`amount`（金额）、`channel`（充值类型）和`bank_code`（银行编码）等。其中，`merchant_no`和`order_no`是必须的，而`bank_code`在对接特定支付通道如`upacp_pc`（网银）时是必要的。 - 商户可以选择性地提供`notify_url`（充值后通知地址）和`result_url`（充值后跳转地址），以及`c_ip`（用户IP）和`extra_param`（公用回传参数）。 - 签名`sign`是基于MD5算法生成的，用于验证数据的完整性和安全性，其值由特定参数和商户密钥组合计算得出。 2. **扫码下单接口**： - 对于某些支付方式，如支付宝手机网页版（alipay_wap）、支付宝电脑版（alipay_pc）、微信手机网页版（wx_wap）等，接口会采用GET方式重定向，因此商户无需处理应答参数。接口返回的参数包括`result_code`（处理状态）、`qrcode`（二维码信息）等。 3. **异步通知**： - 在交易完成后，系统可能会通过`notify_url`发送异步通知，告知商户交易结果，这有助于实时更新订单状态。 4. **错误处理**： - 接口返回的`result_code`可以是`success`或`fail`，表示处理状态。如果失败，可能还会包含`error_code`（错误状态码）和`result_desc`（错误描述）帮助商户诊断问题。 5. **附录**： - **附录1：支付网关** - 提供了不同支付方式的详细信息，例如`channel`字段的各个值代表的含义。 - **附录2：银行编码** - 列出了与接口兼容的不同银行的编码，商户在指定银行编码时可参考此信息。 这些接口的使用有助于简化商户与支付平台之间的交互，确保交易的安全和高效。同时，接口的灵活性允许商户根据自身需求定制支付体验，例如设置回调地址、回传参数等。