收款方必填字段查询

接口信息

• 路径: /api/v1/acct/queryPaymentFeild
• 方法: POST
• Content-Type: application/json

业务说明

• Y 表示必填字段，C 表示条件必填字段，N 表示选填字段。

请求参数

请求体 Request Body

参数名	类型	说明	必填
merchantNo	string	商户号（由oneway提供）	M
payoutCurrency	string(10)	账户币种，例如：PHP	M
bankCountry	string(10)	付款目的国，例如：PH	M
entityType	string(1)	主体类型枚举[0,1]，0:企业，1:个人	M
paymentMethod	string(1)	付款方式	M
walletType	string	钱包类型-付款方式为钱包时	C
sign	string	签名	M

请求示例

{
  "merchantNo": "800538",
  "payoutCurrency": "NGN",
  "bankCountry": "US",
  "entityType": "0",
  "paymentMethod": "BANK_TRANSFER",
  "sign": "skip_verify"
}

响应结果

响应体 Response Body

参数名	类型	说明
respCode	string	响应码
respMsg	string	响应信息
data	object	响应数据
|─merchantNo	string	商户号
|─accountInfomation	object	账户信息
|─cardNumber	string	卡号/IBAN
|─accountType	string	账户类型 [0:checking, 1:saving, 2:ordinary]
|─swiftCode	string	SWIFT代码
|─sortCode	string	Sort Code/ABA路由号
|─branchCode	string	分行编号
|─bankHolderName	string	银行账户持有人姓名
|─walletType	string	钱包类型
|─walletPhone	string	钱包手机号
|─pickUpBankName	string	取款银行名称
|─pickUpBankBranchName	string	取款银行分行名称
|─pickUpBankBranchId	string	取款银行分行ID
|─pickUpBankBranchAddress	string	取款银行分行地址
|─address	object	地址信息
|─state	string	省/州
|─city	string	城市
|─addressLine1	string	地址1
|─addressLine2	string	地址2
|─addressLine3	string	地址3
|─postalCode	string	邮编
|─receiverInfo	object	收款人信息
|─nickName	string	昵称
|─companyName	string	公司名称
|─lastName	string	姓
|─firstName	string	名
|─areaCode	string	区号
|─phone	string	手机号
|─vatNumber	string	增值税号/CPF/CNPJ（巴西）/身份证号（其他国家）
|─birthDate	string	出生日期(yyyy-MM-dd)
|─email	string	收款人邮箱地址（条件字段）

响应示例

{
  "respCode": "20000",
  "respMsg": null,
  "data": {
    "merchantNo": "800538",
    "accountInfomation": {
      "cardNumber": "Y",
      "accountType": "Y",
      "swiftCode": "Y",
      "sortCode": "N",
      "branchCode": "N",
      "bankHolderName": "N",
      "walletType": "N",
      "walletPhone": "N",
      "pickUpBankName": "N",
      "pickUpBankBranchName": "N",
      "pickUpBankBranchId": "N",
      "pickUpBankBranchAddress": "N"
    },
    "address": {
      "state": "N",
      "city": "Y",
      "addressLine1": "Y",
      "addressLine2": "C",
      "addressLine3": "C",
      "postalCode": "Y"
    },
    "receiverInfo": {
      "nickName": "Y",
      "companyName": "Y",
      "lastName": "N",
      "firstName": "N",
      "areaCode": "N",
      "phone": "N",
      "vatNumber": "N",
      "birthDate": "N",
      "email": "N"
    }
  }
}