结算

交易结算明细查询

get

交易结算明细查询

Required scopes

This endpoint requires the following scopes:

Authorizations

Authorization

AuthorizationstringRequired

Query parameters

endTimestring(19)Required

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

gatewayNointeger(8)Optional

网关号；固定长度8位，如：10001001

pageIndexinteger(10)Optional

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

pageSizeinteger(10)Optional

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

startTimeinteger(19)Required

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

Header parameters

authorizationanyRequired

ACCESS_TOKEN，格式：Bearer ACCESS_TOKEN

request-idinteger(20)Required

请求id，最小长度为1，最大长度为20，30分钟之内唯一

request-timeinteger(19)Required

请求时间，时间格式为 yyyy-MM-dd'T'HH:mm:ss ，请求误差不能超过30分钟

Responses

200

OK

*/*response body

get

/openApi/settlementDetails

HTTPcURLJavaScriptPython

GET /openApi/settlementDetails?endTime=null&startTime=null HTTP/1.1
Host: {openApiUrl}
Authorization: YOUR_API_KEY
authorization: null
request-id: null
request-time: null
Accept: */*

200

OK

{
  "data": {
    "list": [
      [
        {
          "batchNo": 320001,
          "cbAmountSettlCurrency": 0,
          "cbFeeSettlCurrency": 0,
          "cbReversalSettlCurrency": 0,
          "chargebackAmount": 0,
          "chargebackFeeAmount": 0.76,
          "chargebackFeeCurrency": "USD",
          "chargebackFeeExchange": 6.36,
          "chargebackReversalAmount": 0,
          "chargebackStatus": 0,
          "gatewayNo": 10001001,
          "handingCharge": 0.75,
          "handlChargeSettlCurrency": 0.25,
          "handlingChargeExchange": 0.36,
          "merNo": 10001,
          "minHandlingCharge": 0.15,
          "minHandlingChargeExchange": 6.36,
          "minTradeFeeSettlCurrency": 0.25,
          "onholdAmountSettlCurrency": 0,
          "onholdStatus": 0,
          "orderNo": 12167001000000000000,
          "paAmountSettlCurrency": 0,
          "rcSettlementExchange": 6.36,
          "refundAmount": 0,
          "refundAmountSettlCurrency": 0,
          "refundFeeAmount": 0,
          "refundFeeCurrency": "USD",
          "refundFeeExchange": 6.36,
          "refundFeeSettlCurrency": 0,
          "refundStatus": 0,
          "remark": "备注",
          "representmentStatus": 0,
          "reserve": 0.55,
          "reserveRatio": 0.52,
          "reserveSettlCurrency": 0.25,
          "retrievalAmount": 0,
          "settlementCurrency": "CNY",
          "settlementRateExchange": 6.36,
          "settlementType": 1,
          "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": 2.0210928100113805e+21,
          "tradeStatus": 1,
          "transactionFeeAmount": 0.76,
          "transactionFeeCurrency": "USD",
          "transactionFeeExchange": 6.36
        }
      ]
    ],
    "page": {
      "pageIndex": 1,
      "pageSize": 100,
      "total": 1000
    }
  },
  "result": {
    "code": "text",
    "message": "text"
  }
}

请求报文示例

payment_method.sh

curl --request GET\
  --url https://{openApiUrl}/openApi/settlementDetails?gatewayNo=12345001&endTime=2022-04-18T18:10:00&pageIndex=1&pageSize=10&startTime=2022-01-21T00:00:00 \
  --header 'request-id: 58675' \
  --header 'request-time: 2022-05-21T23:59:59' \
  --header 'authorization:Bearer 787966BF2479A1BE8E1886CD18E6919447FAF4F357E7056188D4F035661B822' \

结果对象属性描述

result	Object	请求响应对象
code	String	返回码
message	String	返回信息
data	Object	数据对象
page	Object	分页对象
currentPageNo	Integer	当前页
pageSize	Integer	每页条数
total	Integer	记录总条数
list	Array	返回数据
merNo	Integer	商户号
gatewayNo	Integer	网关号
batchNo	Integer	出款批次号
cbAmountSettlCurrency	double	拒付金额(划款币种)
cbFeeSettlCurrency	double	拒付处理费（划款币种）
cbReversalSettlCurrency	double	申诉成功金额(划款币种)
chargebackAmount	double	拒付金额
chargebackFeeAmount	double	拒付处理费
chargebackFeeCurrency	String	拒付处理费币种
chargebackFeeExchange	double	拒付处理费汇率
chargebackReversalAmount	double	申诉成功金额
chargebackStatus	Integer	拒付状态
handingCharge	double	交易手续费
handlChargeSettlCurrency	double	交易手续费(划款币种)
handlingChargeExchange	double	交易扣率
minHandlingCharge	double	最低手续费
minHandlingChargeExchange	double	最低手续费汇率
minTradeFeeSettlCurrency	double	最低单笔手续费(划款币种)
onholdAmountSettlCurrency	double	冻结金额(划款币种)
onholdStatus	Integer	冻结状态
orderNo	String	商户订单号
paAmountSettlCurrency	double	应划金额(划款币种)
rcSettlementExchange	double	异常划款汇率
refundAmount	double	退款金额
refundAmountSettlCurrency	double	退款金额(划款币种)
refundFeeAmount	double	退款处理费
refundFeeCurrency	String	退款处理费币种
refundFeeExchange	double	退款处理费汇率
refundFeeSettlCurrency	double	退款处理费（划款币种）
refundStatus	Integer	退款状态
representmentStatus	Integer	申诉状态
reserve	doubleer	保证金
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	交易状态
transactionFeeAmount	double	单笔手续费
transactionFeeCurrency	String	单笔手续费币种
transactionFeeExchange	double	单笔手续费汇率
remark	String	备注