开放 API v1 · 对账与资金

日账单

POST /api/v1/bill

参数	说明
date	YYYY-MM-DD,服务器时区,默认昨天;不能是未来日期
page / page_size	明细分页,默认 1 / 20,最大 100

按支付完成时间统计当天已支付订单(含手动补单、以及之后被标记退款的订单)。net_income = paid_amount − fee − refund_amount。

{"code":0,"msg":"success","data":{"date":"2026-10-12",
 "summary":{"created_orders":40,"paid_count":35,"paid_amount":"1024.00","fee":"10.24","refund_count":1,"refund_amount":"9.90","net_income":"1003.86"},
 "by_type":[{"type":"alipay","count":20,"amount":"600.00","fee":"6.00","refund_count":0,"refund_amount":"0.00"}, ...],
 "page":1,"page_size":20,"total":35,"list":[{订单对象}, ...]}}

余额流水

POST /api/v1/balance/logs

参数	说明
type	order 订单入账 / settle 提现 / refund 退款扣回 / adjust 管理员调整 / reject 提现驳回退还
start_time / end_time	Unix 时间戳 [start, end)
page / page_size	默认 1 / 20,最大 100

{"code":0,"msg":"success","data":{"page":1,"page_size":20,"total":88,
 "list":[{"id":301,"type":"order","amount":"9.80","before":"100.00","after":"109.80","memo":"订单入账 9.80 (手续费0.10)","created_at":1760320060}]}}

结算记录

POST /api/v1/settle/list 参数 status(pending / paid / rejected,可选)、page、page_size。收款账号脱敏返回。

{"code":0,"msg":"success","data":{"page":1,"page_size":20,"total":3,
 "list":[{"id":7,"amount":"500.00","settle_type":"alipay","account":"138****8000","name":"张三","status":"pending","note":"","created_at":1760320000,"done_at":0}]}}

发起结算

POST /api/v1/settle/apply 参数 amount(元)。

立即从余额扣除并生成待处理的结算记录,由管理员在后台打款后标记完成。收款账号只能是商户资料里已设置的账号,接口无法指定,即使密钥泄露也无法把钱提到别处。

错误	说明
40001	金额格式错误,或低于后台设置的最低提现额
40901	余额不足,或未设置结算账号

{"code":0,"msg":"success","data":{"id":8,"amount":"100.00","status":"pending","account":"138****8000","balance":"23.50"}}