悠悠楠杉
网站页面
易支付接口使用指南
03/29
1. 接口概述
易支付接口采用HTTP协议进行通信，支持GET和POST两种请求方式。所有请求均需通过HTTPS进行，以确保数据传输的安全性。接口主要分为以下部分：
- 初始化：初始化交易环境，获取必要的初始化参数。
- 交易处理：根据用户选择进行支付处理，包括但不限于订单创建、支付请求、支付结果查询等。
- 查询状态：查询交易状态，包括但不限于支付状态、退款状态等。
- 退款处理：支持退款请求及退款状态查询。
- 异常处理：对异常情况进行错误码处理及解决方案指导。
2. 接口调用流程
- 初始化：首先调用初始化接口，获取商户号、秘钥等必要信息。
- 创建订单：根据交易信息创建订单，生成订单号及订单信息。
- 发起支付请求：根据订单信息及用户选择，发起支付请求至易支付系统。
- 支付结果查询：调用查询接口，获取支付结果信息。
- 退款处理：如需退款，可调用退款接口并查询退款状态。
- 异常处理：对于调用过程中出现的错误码，参照文档中的错误码表进行相应处理。
3. 参数说明及使用示例
3.1 初始化参数说明：
merchant_id：商户号，由易支付分配给商户的唯一标识。secret_key：秘钥，用于交易验证及安全校验，保证数据传输的不可篡改性。version：接口版本号，如v1表示使用第一版接口。
json { "merchant_id": "123456", // 示例商户号，实际需替换为真实商户号 "secret_key": "your_secret_key", // 示例秘钥，实际需替换为真实秘钥 "version": "v1" // 使用第一版接口 }
请求方式：POST，URL:https://api.yizhipay.com/init
Header:Content-Type: application/json
Body: JSON数据（如上）
返回结果示例（成功）：{"success": true, "data": {"merchant_token": "xxxxxx"}}
返回结果示例（失败）：{"success": false, "error_code": "xxx", "error_message": "xxx"}（具体错误码见错误码表）
