#虚拟账号查询
#请求路径
/api/v2/virtual/account/label/queryOne#参数列表
| 名称 | 类型 | 长度 | 必填 | 描述 |
|---|---|---|---|---|
| virtualAccountNo | String | 64 | 是 | 虚拟账号的号码 |
#返回值
| 名称 | 类型 | 长度 | 必填 | 描述 |
|---|---|---|---|---|
| virtualAccountName | String | 200 | 是 | 虚拟账号的名称 |
| virtualAccountNo | String | 64 | 是 | 虚拟账号的号码 |
| status | String | 32 | 是 | 虚拟账号的状态: Enabled 、Disabled 、Deleted |
| identityType | String | 32 | 否 | 使用者的证件类型: ● 个人类型并且使用BVN校验 为 "personal" ● 个人类型并且使用NIN校验 为"personal_nin" ● 企业类型并且使用CAC校验 为 "company" |
| licenseNumber | String | 64 | 否 | 证件号码 ● 若证件类型为personal,则传使用人的BVN号码 ● 若证件类型为personal_nin,则传使用人的NIN号码 ● 若证件类型为company,则传公司的CAC号码,注意必须以RC或BN开头 |
| String | 128 | 否 | 使用者的邮箱 | |
| customerName | String | 200 | 否 | 使用者的名称 ● 个人类型 为 个人姓名 ● 企业类型 为 CAC上的公司名 |
| accountReference | String | 120 | 否 | 虚拟账户备注字段 |
#错误码
#Postman请求示例
#request
curl --location 'https://open-gw-sandbox.palmpay-inc.com/api/v2/virtual/account/label/queryOne' \
--header 'Authorization: Bearer L231127063379321376521' \
--header 'countryCode: NG' \
--header 'Signature: ZqffQ7rqN5LvHO4cHAACLfa9ByO3brJmfQy10vRkOJSNLufz/FP45BzPrue35MoY2TiWsMs95BdrbMw1eosX0jznMlTyU7Q6y/BX77XD3XysBWaBBcNqKgjpOVbsVo46Idttg2dvdH8UgYv0dJ9zV/BlZQ8natl7KdTaTzAt9/OrEHmSBWTMLFnT4Uzw/CSSPLEH1zQROcveDDpGfeb6DMcipd5VToodah4CY5VluH2sb86dlVErk2iN5X/Nthpmoy5G83WB1LAz/wto34pmyTVMa+no4ZENGpCe6bIWlAsVefeGWRh80NWEwIKqv/DdC5qtGKnWF/Fj+HENr4ywlw==' \
--header 'content-type: application/json;charset=UTF-8' \
--data '{
"requestTime":1703152050141,
"version":"V2.0",
"nonceStr":"UoRJ1tq114nz05l9GYaKyNN446HNftUH",
"virtualAccountNo":"6664564951"
}'#response
{
"data": {
"identityType": "company",
"licenseNumber": "dasd141234114123",
"virtualAccountName": "PPTV2(Account Suffix of Institution)",
"virtualAccountNo": "6664564951",
"email": "2222@palmpay.com",
"customerName": "palmpayTester",
"status": "Enabled",
"accountReference": "accountReference example"
},
"respMsg": "success",
"respCode": "00000000",
"status": true
}