# 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": "1667198337@grigora.io",
    "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": "1667198337@grigora.io"
    }
}
```

# 查询

---

* {Domain}/v3/payee/retrieve

### Request

* email, customerCode, customerNo 都可以作为查询条件

```json
{
    "customerCode": "1667198337",
    "customerNo": "2000305228294092293550",
    "email": "1667198337@grigora.io",
    "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": "1667198337@grigora.io"
    }
}
```


# 修改

---

* {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": "1667198337@grigora.io",
    "merchantNo": "202333",
    "storeNo": "301854",
    "timestamp":"2022-10-31T10:15:11Z",
    "verifySign": "24d8c40c625b0a8645d1bf574f3ba085"
}
```

### Response

```json
{
    "ret_msg": "delete success",
    "ret_code": "000100"
}
```