收款方详情查询

接口信息

• 路径: /api/v1/beneficiary/queryDetail
• 方法: POST
• Content-Type: application/json

业务说明

• 用于查询单个收款人的详细信息和审核状态
• 在添加收款人后,可通过此接口跟踪审核进度
• 付款前可通过此接口确认收款人状态是否为"PASS"(审核通过)

请求参数

Headers

请求头

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

Request Body

主要参数

参数名	类型	说明	必填
merchantNo	string	商户号（由oneway提供）	M
beneficiaryId	integer	添加收款人时返回的ID	M
sign	string	签名	M

请求示例

Request

{
  "beneficiaryId": "1984102812163112960",
  "sign": "d2ea92efff636320122021f65b613201403f6d34334cfbc7e589ce9f842284u3",
  "merchantNo": 801129
}

响应结果

响应头 Headers

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

响应参数

响应字段

参数名	类型	说明
respCode	string	响应码
respMsg	string	响应信息
data	object	响应数据
└─beneficiaryId	integer	收款人ID
└─createTime	string	创建时间
└─updateTime	string	更新时间
└─merchantNo	integer	商户号
└─nationality	string	国籍
└─status	string	状态
└─remark	string	备注
└─payoutCurrency	string	出款币种
└─expireDate	string	过期时间
└─bankName	string	银行名称
└─accountName	string	账户名称
└─bankAddress	string	银行地址
└─payeeStatus	string	收款人状态
└─accountBelong	string	账号所属 [0:自有,1:他人]
└─bankCountry	string	收款行国家
└─entityType	string	主体类型 [0:企业,1:个人]
└─payeeAddress	string	收款方地址
└─paymentMethod	string	支付方式
└─payeeCountry	string	收款方国家
└─receiverInfo	string	收款人信息
└─address	string	地址信息
└─accountInfomation	string	账户信息

payeeStatus 状态说明

• WAITING: 等待中
• PROCESS: 处理中
• REJECT: 已拒绝
• PASS: 已通过
• FAIL: 失败
• UNNECESSARY: 不需要
• PENDING_UPDATE: 待更新
• DISABLE: 已禁用

响应示例

Response

{
  "respCode": "20000",
  "respMsg": null,
  "data": {
    "beneficiaryId": "1984102812163112960",
    "createTime": "2025-10-31 11:39:07",
    "updateTime": "2025-10-31 11:48:49",
    "merchantNo": "801129",
    "nationality": null,
    "status": "S",
    "remark": null,
    "payoutCurrency": "PKR",
    "expireDate": null,
    "bankName": null,
    "accountName": "betaData testData",
    "bankAddress": null,
    "payeeStatus": "unnecessary",
    "accountBelong": "1",
    "bankCountry": "PK",
    "entityType": "1",
    "payeeAddress": "testdsgddfs1233",
    "paymentMethod": "E_WALLET",
    "payeeCountry": "PK",
    "receiverInfo": "{\"nickName\":\"CyBetatestInvolidPKR3\",\"companyName\":\"helloBoy\",\"lastName\":\"testData\",\"firstName\":\"betaData\",\"areaCode\":\"+92\",\"phone\":\"2313019452\",\"vatNumber\":\"8859884832\",\"birthDate\":\"1990-12-04\",\"email\":null,\"identityNumber\":null,\"identityType\":null}",
    "address": "{\"countryCode\":null,\"state\":\"NY\",\"city\":\"NY\",\"townName\":null,\"addressLine1\":\"testdsgddfs1233\",\"addressLine2\":null,\"addressLine3\":null,\"postalCode\":\"10005\"}",
    "accountInfomation": "{\"cardNumber\":null,\"accountType\":\"\",\"swiftCode\":null,\"sortCode\":null,\"bankName\":\"MCB BankLimited\",\"branchCode\":null,\"bankHolderName\":null,\"walletType\":\"EASYPAISA\",\"walletPhone\":\"03079770877\",\"pickUpBankName\":null,\"pickUpBankBranchName\":null,\"pickUpBankBranchId\":null,\"pickUpBankBranchAddress\":null}"
  }
}

提示

• receiverInfo、address 和 accountInfomation 字段均为 JSON 字符串格式
• 具体字段说明请参考枚举值说明接口