结算明细查询

结算明细相关接口

交易结算明细查询

get

交易结算明细查询

Query parameters

startTimestring(19)Required

开始时间，开始时间与结束时间最大不能超过半年的时间间隔；固定长度为19，如：2022-01-01T00:00:00

endTimestring(19)Required

结束时间，开始时间与结束时间最大不能超过半年的时间间隔；固定长度为19，如：2022-01-01T23:59:59

pageIndexstring(10)Optional

当前页，默认第一页；最大长度为10，如：1

pageSizestring(10)Optional

每页大小，默认每页10条数据，最大1000条；如：100

Header parameters

gateway-nostring(16)Required

网关号

request-idstring(64)Required

请求id，30分钟之内唯一

request-timestring(16)Required

时间戳，以毫秒（ms）为单位，请求误差不能超过10分钟

sign-infostring(255)Required

验签字段，具体加签方式请参阅数据签名过程章节

Responses

200

OK

*/*

get

/openApi/V2022-03/settlementDetails

HTTPcURLJavaScriptPython

GET /openApi/V2022-03/settlementDetails?startTime=null&endTime=null HTTP/1.1
Host: {openApiUrl}
gateway-no: null
request-id: null
request-time: null
sign-info: null
Accept: */*

200

OK

{
  "code": "00000",
  "data": {
    "list": [
      {
        "batchNo": 320001,
        "cbAmountSettlCurrency": 0,
        "cbFeeSettlCurrency": 0,
        "cbReversalSettlCurrency": 0,
        "chargebackAmount": 0,
        "chargebackFeeAmount": 0.76,
        "chargebackFeeCurrency": "USD",
        "chargebackFeeExchange": 6.36,
        "chargebackReversalAmount": 0,
        "chargebackStatus": "non-chargeback",
        "handingCharge": 0.75,
        "handlChargeSettlCurrency": 0.25,
        "handlingChargeExchange": 0.36,
        "minHandlingCharge": 0.15,
        "minHandlingChargeExchange": 6.36,
        "minTradeFeeSettlCurrency": 0.25,
        "onholdAmountSettlCurrency": 0,
        "onholdStatus": "not on-hold",
        "orderNo": "12167001000000000000",
        "paAmountSettlCurrency": 0,
        "rcSettlementExchange": 6.36,
        "refundAmount": 0,
        "refundAmountSettlCurrency": 0,
        "refundFeeAmount": 0,
        "refundFeeCurrency": "USD",
        "refundFeeExchange": 6.36,
        "refundFeeSettlCurrency": 0,
        "refundStatus": "non-refund",
        "remark": "备注",
        "representmentStatus": "non-represented",
        "reserve": 0.55,
        "reserveRatio": 0.52,
        "reserveSettlCurrency": 0.25,
        "retrievalAmount": 0,
        "settlementCurrency": "CNY",
        "settlementRateExchange": 6.36,
        "settlementType": "First settlement",
        "sourceWebSite": "www.asiabill.com",
        "succTransactionAmount": 100.12,
        "tradeAmount": 100.12,
        "tradeAmountSettlCurrency": 65.23,
        "tradeCurrency": "USD",
        "tradeDate": "2021-04-12T00:00:00",
        "tradeFeeSettlCurrency": 0.25,
        "tradeNo": "2021092810011380477264",
        "tradeStatus": "success",
        "transactionFeeAmount": 0.76,
        "transactionFeeCurrency": "USD",
        "transactionFeeExchange": 6.36
      }
    ],
    "page": {
      "pageIndex": 1,
      "pageSize": 100,
      "total": 1000
    }
  },
  "message": "message info"
}

请求报文示例

payment_method.sh

curl --request GET\
  --url https://{openApiUrl}/openApi/V2022-03/settlementDetails?endTime=2022-04-18T18:10:00&pageIndex=1&pageSize=10&startTime=2022-01-21T00:00:00 \
  --header 'request-id: 58675' \
  --header 'request-time: 1651888520935' \
  --header 'gateway-no: 12345001' \
  --header 'sign-info: 787966BF2479A1BE8E1886CD18E6919447FAF4F357E7056188D4F035661B822B

结果对象属性描述

property	type	description
code	String	返回码
message	String	返回信息
data	Object	数据对象
page	Object	分页对象
pageIndex	Integer	当前页
pageSize	Integer	每页条数
total	Integer	记录总条数
list	Array	返回数据
batchNo	Integer	出款批次号
cbAmountSettlCurrency	double	拒付金额(划款币种)
cbFeeSettlCurrency	double	拒付处理费（划款币种）
cbReversalSettlCurrency	double	申诉成功金额(划款币种)
chargebackAmount	double	拒付金额
chargebackFeeAmount	double	拒付处理费
chargebackFeeCurrency	String	拒付处理费币种
chargebackFeeExchange	double	拒付处理费汇率
chargebackReversalAmount	double	申诉成功金额
chargebackStatus	Integer	拒付状态 non-chargeback:未拒付 chargeback:已拒付
handingCharge	double	交易手续费
handlChargeSettlCurrency	double	交易手续费(划款币种)
handlingChargeExchange	double	交易扣率
minHandlingCharge	double	最低手续费
minHandlingChargeExchange	double	最低手续费汇率
minTradeFeeSettlCurrency	double	最低单笔手续费(划款币种)
onholdAmountSettlCurrency	double	冻结金额(划款币种)
onholdStatus	Integer	冻结状态 not on-hold:未冻结 on-hold:已冻结
orderNo	String	商户订单号
paAmountSettlCurrency	double	应划金额(划款币种)
rcSettlementExchange	double	异常划款汇率
refundAmount	double	退款金额
refundAmountSettlCurrency	double	退款金额(划款币种)
refundFeeAmount	double	退款处理费
refundFeeCurrency	String	退款处理费币种
refundFeeExchange	double	退款处理费汇率
refundFeeSettlCurrency	double	退款处理费（划款币种）
refundStatus	Integer	退款状态 non-refund:未退款 refund:已退款
representmentStatus	Integer	申诉状态 non-represented:未申诉 pending:待处理 fail:失败 success:成功
reserve	double	保证金
reserveRatio	double	保证金扣率
reserveSettlCurrency	double	保证金(划款币种)
retrievalAmount	double	冻结金额
settlementCurrency	String	结算币种
settlementRateExchange	double	划款汇率
settlementType	Integer	划款类型 First settlement:首划 Additional settlement:补划
sourceWebSite	String	交易网址
succTransactionAmount	double	成功金额
tradeAmount	double	交易金额(交易币种)
tradeAmountSettlCurrency	double	交易金额(划款币种)
tradeCurrency	String	交易币种
tradeDate	String	交易时间
tradeFeeSettlCurrency	double	单笔手续费(划款币种)
tradeNo	String	流水订单号
tradeStatus	Integer	交易状态 pending:待处理 success:成功 fail:失败
transactionFeeAmount	double	单笔手续费
transactionFeeCurrency	String	单笔手续费币种
transactionFeeExchange	double	单笔手续费汇率
remark	String	备注