Skip to main content

查询 Charge 对象列表

🚀 查看详细参数及数据样例请查看 OpenAPI 接口声明

返回之前创建过 charge 对象的一个列表。列表是按创建时间进行排序,总是将最新的 charge 对象显示在最前。如果不设置 created 参数,默认查询近一个月的数据;设置了 created 参数,会按照对应的时间段查询。

请求参数

NameTypeDescription
app_idstring[REQUIRED] 应用 id
limitint[OPTIONAL] 限制有多少对象可以被返回,限制范围是从 1~100 项,默认是 10 项
starting_afterstring[OPTIONAL] 在分页时使用的指针,决定了列表的第一项从何处开始。假设你的一次请求返回列表的最后一项的 id 是 obj_end,你可以使用 starting_after = obj_end 去获取下一页
ending_beforestring[OPTIONAL] 在分页时使用的指针,决定了列表的最末项在何处结束。假设你的一次请求返回列表的第一项的 id 是 obj_start,你可以使用 ending_before = obj_start 去获取上一页
merchant_trade_idstring[OPTIONAL] 客户系统订单号
created_ltint大于 charge 对象的创建时间,用 Unix 时间戳表示
created_lteint大于或等于 charge 对象的创建时间,用 Unix 时间戳表示
created_gtint小于 charge 对象的创建时间,用 Unix 时间戳表示
created_gteint小于或等于 charge 对象的创建时间,用 Unix 时间戳表示
channelstring[OPTIONAL] 渠道名称 - BALANCE: 余额支付 - AlipayQR: 支付宝扫码支付 - AlipayScan: 支付宝条码支付 - AlipayApp: 支付宝 App 支付 - AlipayWap: 支付宝手机网站支付 - AlipayPage: 支付宝电脑网站支付 - AlipayFace: 支付宝刷脸支付 - AlipayLite: 支付宝小程序支付 - WechatpayApp: 微信 App 支付 - WechatpayJSAPI: 微信 JSAPI 支付 - WechatpayH5: 微信 H5 支付 - WechatpayNative: 微信 Native 支付 - WechatpayLite: 微信小程序支付 - WechatpayFace: 刷脸支付 - WechatpayScan: 微信付款码支付
paidbool[OPTIONAL] 是否已付款
refundedbool[OPTIONAL] 是否存在退款信息,无论退款是否成功。
reversedbool[OPTIONAL] 是否已撤销
closedbool[OPTIONAL] 是否已关闭
expiredbool[OPTIONAL] 是否已过期

返回结果

返回一个已存在的 charge 对象列表或者一个错误。