清算记录查询接口

Endpoint
POST {BASE_URL}/api/v2.0/payments/settlements

查询指定日期的清算记录

Request Body
datestringREQUIRED

需要查询日期，精确到天，例如：20230516
需符合正则: ((19|20)\d{2}(0[1-9]|1[0-2])(0[1-9]|[12]\d|3[01]))

清算记录查询Request Body
{
    "date": "string"
}
Response (200 OK)
settlementsarray [object]

清算记录列表

隐藏子字段
settlements.settleInfoobject

清算信息

隐藏子字段
settlements.settleInfo.settleNostring

清算唯一编号

settlements.settleInfo.creditAmountstring

本次结算入账金额

settlements.settleInfo.debitAmountstring

本次结算出账金额

settlements.settleInfo.netAmountstring

本次结算净交易金额 creditAmount-debitAmount

settlements.settleInfo.serviceFeestring

AlphaPay平台服务费

settlements.settleInfo.settleAmountstring

清算金额

settlements.bankInfoobject

银行信息

隐藏子字段
settlements.bankInfo.storeCodestring

店铺编号：商家自行设置

settlements.bankInfo.companyNamestring

商户银行开户名称

settlements.bankInfo.transitNostring

支行编号

settlements.bankInfo.institutionNostring

银行编号

settlements.bankInfo.accountNostring

商户银行账号

resultobject

业务结果

隐藏子字段
result.resultCodestring

业务结果码，详情查看业务结果码 (resultCode)

result.resultMessagestring

业务结果消息

result.resultStatusstring

业务结果状态，详情查看业务结果状态 (resultStatus)

  • S：接口调用成功
  • F：接口调用失败，resultMessage会有详细的错误信息描述，可能是商户也可能是平台的错误。
  • U：业务结果未知或处理中间状态。比如提交支付单后得到 PAYMENT_IN_PROCESS，则需要调用查询接口确认支付结果状态
清算记录查询Response
{
    "settlements": [
        {
            "settleInfo": {
                "settleNo": "string",
                "creditAmount": "string",
                "debitAmount": "string",
                "netAmount": "string",
                "serviceFee": "string",
                "settleAmount": "string"
            },
            "bankInfo": {
                "storeCode": "string",
                "companyName": "string",
                "transitNo": "string",
                "institutionNo": "string",
                "accountNo": "string"
            }
        }
    ],
    "result": {
        "resultCode": "string",
        "resultMessage": "string",
        "resultStatus": "S"
    }
}