Please reach out to the Pockyt team at [email protected] to make sure your account is setup properly before testing Chinese payouts.

1. Registering a Chinese Payee

Sample body for registering Chinese Payee

{
    "countryCode": "CN",
    "city": "北京市",
    "country": "中国",
    "customerCode": "2296617293062266"
    "dateOfBirth": "2001-01-01",,
    "email": "[email protected]",
    "firstName": "三",
    "governmentId":"140421200101017700",
    "governmentIdType":"ID_CARD",
    "lastName": "张",
    "profileType": "INDIVIDUAL",
    "merchantNo": "{{merchantNo}}",
    "state": "北京",
    "street": "中南海",
    "storeNo": "{{storeNo}}",
    "verifySign": "{{verifySign}}",
    "timestamp": "{{currentTime}}",
    "zip": "100000"
}

  • Note: for testing purposes and data verification
    • Payee information needs to match the ID provided, most notably the birthday
    • Payee name must be in Chinese
  • Save the customerNo to be used for the additional requests below.

2. Retrieve additional required fields from Transfer Methods

  • In addition to the required fields as detailed in the Add Payee Funding Methods documentation, also consult the Transfer Methods Endpoint to get additional required fields for Chinese Payouts.

Additional Required Fields

Field NameRequiredDescription
cardNumberYChinese bank number
bankCodeYChinese bank code
governmentIdYMatching ID from payee registration
governmentIdTypeYId type. Set as "ID_CARD"

3. Upload the funding information through Add Payee Funding Method

Sample body for request to Add Payee Endpoint

{
    "accountCountry": "CN",
    "accountCurrency": "CNY",
    "accountTag": "22966778830615590",
    "accountType": "BANK_ACCOUNT",
    "bankAccountId": "123213412",
    "branchId": "12312321",
    "bankCode":"01050000",
    "cardNumber":"6227000060741686775",
    "customerNo": "2000377140035196350572",
    "clientIp":"127.0.0.1",
    "governmentId":"140421200101017700",
    "governmentIdType":"ID_CARD",
    "timestamp": "{{currentTime}}",
    "verifySign": "{{verifySign}}",
    "merchantNo": "{{merchantNo}}",
    "storeNo": "{{storeNo}}"
}

Store the returned account token to use for future transactions.

Appendix

Supported Chinese Bank Codes

View supported Chinese banks here.