Skip to content

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 条