Frank
/
docs
1
0
Fork 1
Code Issues Pull Requests Projects Releases Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
9 Commits
1 Branch
0 Tags
95 KiB
 
Tree: 0e9d514a35
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '0e9d514a35'
${ noResults }
docs/payout/payee.md

3.7 KiB
Raw Blame History

Payee Registration

  • {Domain}/v3/payee/register

Request

  • governmentIdType: 中国大陆用户需要使用身份证号码，type = ID_CARD

  • 注册成功之后，Payee会收到注册通知邮件，根据指引登录Yuansfer Portal提交相关信息，激活账户之后才可以接收转账。

参数名 描述
customerCode 商户系统客户编号
dateOfBirth 大于18岁
｜governmentId 中国大陆公民使用居民身份证号码
lastName 姓，中国公民使用中文，与身份证姓名一致
firstName 名，中国公民使用中文，与身份证姓名一致 
{
    "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

{
    "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 都可以作为查询条件
{
    "customerCode": "1667198337",
    "customerNo": "2000305228294092293550",
    "email": "[email protected]",
    "merchantNo": "202333",
    "storeNo": "301854",
    "timestamp":"2022-10-31T10:13:05Z",
    "verifySign": "2ed37ef290331e712e1f46b278913b5d"
}

Response

{
    "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

{
    "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

{
    "ret_msg": "update success",
    "ret_code": "000100"
}

删除

  • {Domain}/v3/payee/delete

Request

{
    "customerNo": "2000305228294092293550",
    "email": "[email protected]",
    "merchantNo": "202333",
    "storeNo": "301854",
    "timestamp":"2022-10-31T10:15:11Z",
    "verifySign": "24d8c40c625b0a8645d1bf574f3ba085"
}

Response

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