Skip to main content
GET
获取资金流水账单

概述

本页说明 GET /v1/pay/bill/orderlist 接口。完整的请求参数、响应结构与示例由上方关联的 OpenAPI 定义渲染。

说明

请求头

X-GatePay-Certificate-ClientId
string
必填

商户客户端ID,在 GatePay 平台申请获得

示例:

"4186d0c6-6a35-55a9-8dc6-5312769dbff8"

X-GatePay-Signature
string
必填

HMAC-SHA256签名,用于验证请求合法性

示例:

"672d5650dcc9bb22ebf25fa16c28d03c0e159d742a9176d4340a5da326d75dc8a2ec24c97fa6fc5d1533dd6e968863747e1d86a45e562cbe899f9ed7e9ca7f77"

X-GatePay-Timestamp
string
必填

毫秒级时间戳,与服务端时间偏差不得超过30秒

示例:

"1672905655498"

X-GatePay-Nonce
string
必填

随机数,用于防止重放攻击

示例:

"3525756760"

查询参数

startTime
integer<int64>
必填

开始时间,单位毫秒

endTime
integer<int64>
必填

结束时间,单位毫秒

page
integer
必填

分页编号,从 1 开始

count
integer
必填

获取一页条数,最大 500

currency
string

搜索币种

financialType
enum<string>

财务类型。可选值:收款 (receipt_fi)、礼品卡 (giftCard_fi)、礼品卡作废 (gift_voided)、奖励 (reward_fi)、划转(下发) (distribution_fi)、退款 (refund_fi)、退款到商户 (refund_to_merchant_fi)、划转 (transfer_fi)、闪兑(买入) (convert_buy_fi)、闪兑(卖出) (convert_sell_fi)、闪兑(退款) (convert_refund_fi)、法币充值 (otcRecharge_add_fi)、法币充值 (fiatRecharge_add_fi)、法币提现 (otcWithdraw_fi)、下发 (disburse_fi)、退款(下发失败) (refund_disburse_failed_fi)、理财派息 (dividend)、收益分成 (agent_fee_fi)、加密货币充值 (crypto_recharge_fi)、法币支付 (fiat_pay)、主账户手续费 (main_account_fee)、主账户退手续费 (main_account_refund_fee)、手续费 (refund_fee_fi)、退还手续费 (refund_fee_return_fi)、其他 (others_fi)。

可用选项:
receipt_fi,
giftCard_fi,
gift_voided,
reward_fi,
distribution_fi,
refund_fi,
refund_to_merchant_fi,
transfer_fi,
convert_buy_fi,
convert_sell_fi,
convert_refund_fi,
otcRecharge_add_fi,
fiatRecharge_add_fi,
otcWithdraw_fi,
disburse_fi,
refund_disburse_failed_fi,
dividend,
agent_fee_fi,
crypto_recharge_fi,
fiat_pay,
main_account_fee,
main_account_refund_fee,
refund_fee_fi,
refund_fee_return_fi,
others_fi
orderType
integer

查询订单类型:1-商户订单号 2-GatePay订单号 3-资金流水订单号

orderIdNo
string

查询单号

transactionType
integer

收支类型:1-收入 2-支出

sortType
string

排序方式:pay_time_desc-入账时间降序 pay_time_asc-入账时间升序,默认 pay_time_desc

响应

200 - application/json

查询成功

status
string
必填

响应状态

示例:

"SUCCESS"

code
string
必填

响应码

示例:

"000000"

errorMessage
string

错误信息

示例:

""

data
object