Appearance
ZenPay 通用支付
统一支付渠道接入,支持付款与退款两种模式
常用方法
| 方法名 | 说明 |
|---|---|
| ZenPay create(String orderId, long amount, String channel) | 创建支付对象 |
| void attach(String key, String value) | 添加自定义附加信息 |
| String create(String uid) | 创建支付单,指定付款人 |
| String refound(String uid) | 创建退款单,指定被退款人 |
| String setOpenId(String openId) | 指定付款人平台 ID,默认取 uid 绑定的 openId |
| String setAppId(String appId) | 指定付款的应用,默认取渠道的 appId |
支付对象属性
| 属性名 | 说明 |
|---|---|
| scene | 支付的业务场景 |
| attach | 支付附加业务信息,选填。JSON 类型 注:微信 h5 支付,attach 为必填且需包含 payerIp(用户的客户端 IP,支持 IPv4 和 IPv6 两种格式的 IP 地址),h5Type(使用 H5 支付的场景:Wap、iOS、Android) |
PayKit 付款工具类
- 付款状态:0 待付款/待退款,1 付款中/退款中,2 已付款/退款,3 付款失败/退款失败,4 对账完成
| 方法名 | 说明 |
|---|---|
| PayDO get(String id) | 获取付款对象 |
| PayDO getByOrderId(String orderId, int type) | 根据订单 ID 查询最后一次支付信息 |
| boolean isFinished(String payId) | 判断状态是否完成 |
| List<String> isFinished(List<String> payIds) | 批量校验支付状态是否完成,返回完成的 ID |
| void finish(String id) | 标记完成 |
| void finish(String id, Map<String, Object> result) | 标记完成,并将结果缓存 |
| void affirm(String id) | 业务对账确认 |
| void fail(String id) | 标记付失败 |
| void updateStatus(String id, int status) | 更新状态 |
| void setTradeId(String id, String tradeId) | 更新外部交易 ID |
| List<PayDO> queue() | 获取待付款/待退款队列,每次最多返回 100 条 |
| List<PayDO> queryByStatus(int status) | 根据状态查询订单,每次最多返回 100 条 |
| List<PayDO> unaffirm() | 查询未对账订单,每次最多返回 100 条 |