|
|
# Payee Registration
---
* {Domain}/v3/payee/register
### Request
* `governmentIdType`: 中国大陆用户需要使用身份证号码，type = `ID_CARD`
* 注册成功之后，Payee会收到注册通知邮件，根据指引登录Yuansfer Portal提交相关信息，激活账户之后才可以接收转账。
|参数名|描述||---|---||customerCode|商户系统客户编号||dateOfBirth|大于18岁||governmentId|中国大陆公民使用居民身份证号码||lastName|姓，中国公民使用中文，与身份证姓名一致||firstName|名，中国公民使用中文，与身份证姓名一致|
```json{ "city": "北京", "country": "中国", "countryCode": "CN", "customerCode": "1667198337", "dateOfBirth": "1999-01-01", "email": "[email protected]", "firstName": "三", "governmentId": "110101199003074493", "governmentIdType": "ID_CARD", "lastName": "张", "merchantNo": "202333", "phone": "1234567890", "profileType": "INDIVIDUAL", "state": "北京", "storeNo": "301854", "street": "长城", "street2": "", "verifySign": "141803fb1e21ff977d7fa5f68067860a", "zip": "100000"}```
### Response
```json{ "ret_msg": "success", "ret_code": "000100", "customer": { "firstName": "三", "lastName": "张", "customerCode": "1667198337", "createdTime": "2022-10-31T06:40:20Z", "customerNo": "2000305228294092293550", "email": "[email protected]" }}```
# 查询
---
* {Domain}/v3/payee/retrieve
### Request
* email, customerCode, customerNo 都可以作为查询条件
```json{ "customerCode": "1667198337", "customerNo": "2000305228294092293550", "email": "[email protected]", "merchantNo": "202333", "storeNo": "301854", "timestamp":"2022-10-31T10:13:05Z", "verifySign": "2ed37ef290331e712e1f46b278913b5d"}```
### Response
```json{ "ret_msg": "query success", "ret_code": "000100", "customer": { "zip": "100000", "lastName": "张", "country": "中国", "updatedTime": "2022-10-31T06:40:20Z", "city": "北京", "customerCode": "1667198337", "dateOfBirth": "1999-01-01", "firstName": "三", "phone": "1234567890", "countryCode": "CN", "street": "长城", "createdTime": "2022-10-31T06:40:20Z", "state": "北京", "lang": "en", "customerNo": "2000305228294092293550", "email": "[email protected]" }}```
# 修改
---
* {Domain}/v3/payee/update* 已激活(审核通过)的账号不允许再修改，会报错
### Request
```json{ "customerNo":"2000305228294092293550", "city": "北京", "country": "中国", "countryCode": "CN", "customerCode": "1667198337", "dateOfBirth": "1999-01-02", "firstName": "三", "governmentId": "110101199003074493", "governmentIdType": "ID_CARD", "lastName": "张", "merchantNo": "202333", "phone": "1234567890", "profileType": "INDIVIDUAL", "state": "北京", "storeNo": "301854", "street": "中南海", "street2": "No. 123", "verifySign": "55704c3e018d7878f3be3f14b472e05f", "zip": "100001"}```
### Response
```json{ "ret_msg": "update success", "ret_code": "000100"}```
# 删除
---
* {Domain}/v3/payee/delete
### Request
```json{ "customerNo": "2000305228294092293550", "email": "[email protected]", "merchantNo": "202333", "storeNo": "301854", "timestamp":"2022-10-31T10:15:11Z", "verifySign": "24d8c40c625b0a8645d1bf574f3ba085"}```
### Response
```json{ "ret_msg": "delete success", "ret_code": "000100"}```
|
