docs/payout/payout-account.md

# 添加收款账号

* {Domain}/v3/customers/account/create/bank-account

### 收款账号类型

|类型|api|描述|
|---|---|---|
|BANK_ACCOUNT|bank-account|银行账号/卡号|
|PAYPAL|paypal|PayPal|
|VENMO|venmo|Venmo|


### Request

```json
{
    "accountCountry": "CN",
    "accountCurrency": "CNY",
    "accountTag": "1667217845",
    "accountType": "BANK_ACCOUNT",
    "bankAccountId": "6227000734730752257",
    "bankName": "中国建设银行",
    "clientIp": "2401:1740:1000:0:801:6666:20cd:6034",
    "customerNo": "2000305228294106374322",
    "ipnUrl": "https://example.com/notify",
    "merchantNo": "202333",
    "storeNo": "301854",
    "timestamp": "2022-10-31T12:04:05Z",
    "verifySign": "6d131346908c10e76583a3c1c24d3a4f"
}
```

### Response

```json
{
    "result":
    {
        "accountTag": "1667217845",
        "accountStatus": "ACTIVATED",
        "country": "CN",
        "lastName": "雄",
        "firstName": "霸",
        "accountType": "BANK_ACCOUNT",
        "currency": "CNY",
        "accountToken": "2010305228294111721580",
        "customerNo": "2000305228294106374322",
        "email": "[email protected]",
        "timestamp": "2022-10-31T12:04:08Z",
        "status": "success"
    },
    "ret_msg": "success",
    "ret_code": "000100"
}
```


# 查询收款人账号信息

---

* {Domain}/v3/payee/payout-accounts

## 查询成功

### Request

* 查询由收款人登录portal，自己添加的银行账号，PayPal账号，Alipay账号等

```json
{
    "merchantNo": "202333",
    "storeNo": "301854",
    "customerNo": "2000305228289295850180",
    "verifySign": "05a150f56706f9a435748eb986c2daad",
    "timestamp": "2022-10-10T18:25:52Z"
}
```

### Response

```json
{
    "accounts": [
        {
            "accountTag": "ee1d4197-36aa-4991-952c-0a9b35f505dd",
            "country": "CN",
            "createdAt": "2022-09-05T18:27:40Z",
            "accountType": "BANK_ACCOUNT",
            "currency": "CNY",
            "accountToken": "2010305228289296332658",
            "cardNumber": "****5655",
            "status": "activated"
        }
    ],
    "ret_msg": "success",
    "user": {
        "firstName": "俊义",
        "lastName": "卢",
        "customerNo": "2000305228289295850180",
        "email": "[email protected]"
    },
    "ret_code": "000100"
}
```

## 通过`accountTag` 查询单个账号

### Request 

```json
{
    "merchantNo": "202333",
    "storeNo": "301854",
    "customerNo": "2000305228289295850180",
    "accountTag":"ee1d4197-36aa-4991-952c-0a9b35f505dd",
    "verifySign": "700655e94a50e7e3e6115ade9665ae87",
    "timestamp": "2022-10-31T07:11:29Z"
}
```

### Response

```json
{
    "result": {
        "accountTag": "ee1d4197-36aa-4991-952c-0a9b35f505dd",
        "country": "CN",
        "createdAt": "2022-09-05T18:27:40Z",
        "firstName": "俊义",
        "lastName": "卢",
        "accountType": "BANK_ACCOUNT",
        "currency": "CNY",
        "accountToken": "2010305228289296332658",
        "customerNo": "2000305228289295850180",
        "email": "[email protected]",
        "cardNumber": "****5655",
        "status": "activated"
    },
    "ret_msg": "success",
    "ret_code": "000100"
}
```

## 查询失败，payee账号待审核

### Request

```json
{
    "merchantNo": "202333",
    "storeNo": "301854",
    "customerNo": "2000305228294092293550",
    "verifySign": "b7168db325fa9a3c49e8b62fd2dab4ff",
    "timestamp": "2022-10-31T06:51:20Z"
}
```

### Response

```json
{
    "ret_code": "000040",
    "ret_msg": "payee status Unverified"
}
```