1. 简介

易支付（EasyPay）接口API是专为电子商务、在线服务平台及任何需要便捷支付解决方案的商业实体设计的一套完整的支付服务接口。该API支持多种支付方式，包括但不限于信用卡、借记卡、电子钱包、以及各类本地支付方法，旨在为用户提供安全、高效、灵活的支付体验。

2. 接口概览

2.1 初始化支付请求

请求方法：

• POST /api/v1/payment/init

请求参数：

• amount (required): 交易金额（单位：分）
• currency (required): 交易货币（如：CNY, USD）
• customer_id (required): 用户ID或用户唯一标识符
• description (optional): 交易描述或订单备注
• callback_url (optional): 异步通知回调URL
• pay_method (optional): 指定支付方式（如：creditcard, wechatpay, alipay）

返回示例：

json { "status": "success", "payment_id": "1234567890", "payment_url": "https://pay.example.com/pay?pid=1234567890" }

2.2 查询支付状态

请求方法：

• GET /api/v1/payment/status?paymentid=xxxxxx&customerid=yyyyyy

请求参数：

• payment_id (required): 支付请求的唯一标识符
• customer_id (required): 用户ID或用户唯一标识符，用于验证用户身份及支付关联性

返回示例：

json { "status": "success", "payment_status": "completed", "amount": 1000, // 分为单位，即10元人民币 "currency": "CNY", "transaction_id": "ZZZ1234567890" // 交易流水号，由支付服务商提供 }

2.3 退款处理

请求方法：

• POST /api/v1/refund/request?paymentid=xxxxxx&amount=yyyyyy&currency=zzzzzz&reason=reasontext

请求参数：

• payment_id (required): 需要退款的支付请求的唯一标识符
• amount (required): 退款金额（单位：分）
• currency (required): 退款货币（如：CNY, USD）
• reason (optional): 退款原因描述（最大长度100字符）
• customer_id (optional): 用户ID或用户唯一标识符，可选但推荐提供以增强安全性及效率

返回示例：

json { "status": "success", "refund_id": "1234567890", // 退款请求的唯一标识符，可用于后续查询状态或取消操作等。 "refund_url": "https://refund.example.com/refund?rid=1234567890" // 可选，若需要用户点击的链接进行退款确认等操作。 }

2.4 查询退款状态：GET /api/v1/refund/status?refundid=xxxxxx&customerid=yyyyyy // 待实现后补充具体信息...