# 收款方详情查询 > 查询单个收款方的资料详情和审核状态。 ```yaml openapi: 3.1.0 info: title: 收款方详情查询 version: 1.0.0 description: 查询单个收款方的资料详情和审核状态。 paths: /api/v1/beneficiary/queryDetail: post: summary: 收款方详情查询 description: 查询单个收款方的资料详情和审核状态。 requestBody: required: true content: application/json: schema: type: object properties: merchantNo: type: string description: Onerway 分配的商户号。通常在沙盒或生产商户开通后，从商户后台或开户材料中获取。 beneficiaryId: type: string description: 创建收款方接口返回的收款方 ID。 sign: type: string description: 请求签名字符串，需使用商户私钥按 Transfer 请求签名规则生成。 required: - merchantNo - beneficiaryId - sign examples: get-beneficiary-details: summary: 收款方详情请求示例 value: beneficiaryId: "1984102812163112960" merchantNo: 801129 sign: d2ea92efff636320122021f65b613201403f6d34334cfbc7e589ce9f842284u3 responses: "200": description: 收款方详情响应示例 content: application/json: schema: type: object properties: respCode: type: string description: Onerway 返回的响应码。 respMsg: type: - string - "null" description: Onerway 返回的响应信息。 x-onerway-value: nullable: true when: en: No response message is returned. zh: 未返回响应信息时为 `null`。 data: type: object properties: beneficiaryId: type: string description: 收款方 ID。 createTime: type: string description: 收款方记录创建时间。 updateTime: type: string description: 收款方记录最后更新时间。 merchantRefId: type: string description: 商户侧收款方引用 ID。 merchantNo: type: string description: 商户号。 nationality: type: - string - "null" description: 收款方国籍，未提供时可能为空。 x-onerway-value: nullable: true status: type: string description: 收款方记录状态码。 remark: type: - string - "null" description: 审核补充备注，未返回时可能为空。 x-onerway-value: nullable: true payoutCurrency: type: string description: 该收款方配置的打款币种。 expireDate: type: - string - "null" description: 收款方记录的到期日，如无则为空。 x-onerway-value: nullable: true bankName: type: - string - "null" description: 适用时返回的收款银行名称。 x-onerway-value: nullable: true accountName: type: - string - "null" description: 收款账户名。 x-onerway-value: nullable: true bankAddress: type: - string - "null" description: 适用时返回的收款银行地址。 x-onerway-value: nullable: true payeeStatus: type: string description: 用于打款前确认的收款方审核状态。 accountBelong: type: string description: 账户归属类型编码。 bankCountry: type: string description: 收款账户银行国家。 entityType: type: string description: 收款方主体类型。 payeeAddress: type: string description: 收款方地址摘要。 paymentMethod: type: string description: 该收款方配置的付款方式。 payeeCountry: type: string description: 收款方国家。 receiverInfo: type: string description: 以 JSON 字符串编码的收款人身份信息。 contentMediaType: application/json contentSchema: type: object properties: nickName: type: string description: nickName 字段。 companyName: type: string description: companyName 字段。 lastName: type: string description: lastName 字段。 firstName: type: string description: firstName 字段。 areaCode: type: string description: areaCode 字段。 phone: type: string description: phone 字段。 vatNumber: type: string description: vatNumber 字段。 birthDate: type: string description: birthDate 字段。 email: type: string description: email 字段。 identityNumber: type: string description: identityNumber 字段。 identityType: type: string description: identityType 字段。 x-onerway-format: json_string address: type: string description: 以 JSON 字符串编码的收款地址信息。 contentMediaType: application/json contentSchema: type: object properties: countryCode: type: string description: countryCode 字段。 state: type: string description: state 字段。 city: type: string description: city 字段。 townName: type: string description: townName 字段。 addressLine1: type: string description: addressLine1 字段。 addressLine2: type: string description: addressLine2 字段。 addressLine3: type: string description: addressLine3 字段。 postalCode: type: string description: postalCode 字段。 x-onerway-format: json_string accountInfomation: type: string description: 以 JSON 字符串编码的收款账户信息。 contentMediaType: application/json contentSchema: type: object properties: cardNumber: type: string description: cardNumber 字段。 accountType: type: string description: accountType 字段。 swiftCode: type: string description: swiftCode 字段。 sortCode: type: string description: sortCode 字段。 bankName: type: string description: bankName 字段。 branchCode: type: string description: branchCode 字段。 bankHolderName: type: string description: bankHolderName 字段。 walletType: type: string description: walletType 字段。 walletPhone: type: string description: walletPhone 字段。 pickUpBankName: type: string description: pickUpBankName 字段。 pickUpBankBranchName: type: string description: pickUpBankBranchName 字段。 pickUpBankBranchId: type: string description: pickUpBankBranchId 字段。 pickUpBankBranchAddress: type: string description: pickUpBankBranchAddress 字段。 x-onerway-format: json_string description: 收款方详情及审核状态。 examples: beneficiary-details-returned: summary: 收款方详情响应示例 value: 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}' ```