付款单笔查询

接口信息

• 路径: /api/v1/txn/query
• 方法: POST
• Content-Type: application/json

业务说明

• 用于查询单笔付款交易的详细状态
• 可通过requestId或payoutId查询
• 在付款后通过此接口确认交易状态

请求参数

Headers

请求头

参数名	值	必填	说明
Content-Type	application/json	是	请求体类型

Request Body

主要参数

参数名	类型	说明	必填
merchantNo	string	商户号	M
requestId	string(32)	业务流水号	C-若payoutId为空，则必填
payoutId	integer(32)	付款流水ID	C-若requestId为空，则必填
sign	string	签名	N

请求示例

Request

{
  "merchantNo": "800225",
  "requestId": "REQ20240101123456789012345678901",
  "payoutId": 1808783413957234688,
  "sign": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"
}

响应结果

响应头 Headers

参数名	值	必填	说明
content-type	application/json;charset=UTF-8	否	响应体类型

响应参数

响应字段

参数名	类型	说明
respCode	string	响应码
respMsg	string	响应信息
data	object	响应数据
└─merchantNo	string	商户号
└─requestId	string	业务流水号
└─payoutId	integer	付款流水ID
└─status	string	Status枚举值
└─settleCurrency	string	结算币种
└─settleSumAmount	number	结算单汇总金额
└─serviceFee	number	手续费
└─convRate	number	转换汇率
└─payerDetail	string	付款方详情

响应示例

Response

{
    "respCode": "20000",
    "respMsg": null,
    "data": {
        "merchantNo": "801040",
        "requestId": "DM20250888804123",
        "payoutId": "1954374604177408000",
        "status": "P",
        "settleCurrency": "USD",
        "settleSumAmount": 8.939382,
        "serviceFee": -2.089382,
        "convRate": 277.564623,
        "payoutStatusReason": null,
        "payerDetail": {
            "id": "1954374605835165698",
            "merchantNo": "800149",
            "companyNameEn": null,
            "companyName": null,
            "country": "HK",
            "addressEn1": "Nanshan Science & Technology Park, Shenzhen",
            "addressEn2": "2",
            "addressEn3": "3",
            "registerNo": null,
            "registerDate": null,
            "postcode": "518057",
            "status": 0,
            "isDeleted": null,
            "creator": null,
            "updator": null,
            "createTime": "2025-08-08 14:59:13",
            "updateTime": null,
            "email": "1@qq.com",
            "areaCode": "+91",
            "phoneNumber": "9884783388",
            "state": "hubei",
            "city": "wuhan",
            "subEntityType": "1",
            "firstName": "zhang",
            "lastName": "san2",
            "idType": "0",
            "idNumber": "371328198410044019",
            "birthDate": "1984-10-04",
            "idValidDateFrom": "2016-08-04",
            "idValidDateTo": "2026-08-04",
            "payerId": "1953712585351499776",
            "payoutId": "1954374604177408000"
        }
    }
}