# Beneficiary

| uuid                   | String Generated                 | M                                                 | Object unique identifier                                                                                                                                                                                                                                                                                                             |
| ---------------------- | -------------------------------- | ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| merchantID             | String Generated                 | M                                                 | Merchant unique identifier                                                                                                                                                                                                                                                                                                           |
| referenceID            | String                           | M                                                 | Merchant beneficiary reference ID                                                                                                                                                                                                                                                                                                    |
| <p>name</p><p><br></p> | String                           | M                                                 | <p>Beneficiary name<br><br>^\[a-zA-Z\s]{1,70}$</p><p><br></p><p>Length Max 70</p>                                                                                                                                                                                                                                                    |
| countryCode            | Enum                             | M                                                 | <p>Beneficiary two-letter country code based on ISO 3166-1<br><br></p><p><br></p><p>Value:</p><p>Should be either</p><ul><li>SG</li><li>MY</li><li>TH</li><li>JP</li><li>CN</li><li>AU</li><li>US</li><li>KR</li><li>GB</li><li>DE</li><li>NL</li><li>ES</li><li>IT</li><li>TW</li><li>VN</li><li>HK</li><li>PL</li><li>SE</li></ul> |
| state                  | String                           | M                                                 | <p>Beneficiary state<br><br>Length: Max 50</p>                                                                                                                                                                                                                                                                                       |
| city                   | String                           | M                                                 | <p>Beneficiary city<br><br>Length: Max 35</p>                                                                                                                                                                                                                                                                                        |
| address                | String                           | M                                                 | <p>Beneficiary address<br><br>^.{1,200}$</p><p>Length Max 200</p>                                                                                                                                                                                                                                                                    |
| postcode               | Number                           | M                                                 | <p>Beneficiary postcode<br><br>Length: Max 15</p>                                                                                                                                                                                                                                                                                    |
| accountType            | <p>Enum </p><p><br></p>          | M                                                 | <p>Beneficiary account type (individual or company)<br><br></p><p>Value Should be either</p><ul><li>Individual</li><li>Company</li></ul>                                                                                                                                                                                             |
| bankName               | String                           | M                                                 | <p>Beneficiary bank name<br><br>^\[A-z0-9., -]{1,100}$</p><p><br></p><p>Max 100</p><p>Only allows special characters . , -</p>                                                                                                                                                                                                       |
| bankCode               | <p>String </p><p><br></p><p></p> | <p>C<br>Required if beneficiary country is KR</p> | <p>Beneficiary bank code</p><p>Length: Max 3</p>                                                                                                                                                                                                                                                                                     |
| accountNumber          | String                           | M                                                 | Beneficiary bank account number                                                                                                                                                                                                                                                                                                      |
| contactCountryCode     | String                           | <p>C<br>Required if beneficiary country is KR</p> | <p>Beneficiary contact country code</p><p><br>Length: Max 5</p>                                                                                                                                                                                                                                                                      |
| contactNumber          | <p>String <br></p><p></p>        | <p>C<br>Required if beneficiary country is KR</p> | <p>Beneficiary contact number</p><p><br><br>^\[0-9+/-\s]{0,17}$</p><p><br></p><p>Max 17</p><p>Can contain + - space numbers</p>                                                                                                                                                                                                      |
| email                  | String                           | <p>C<br>Required if beneficiary country is KR</p> | <p>Beneficiary email</p><p><br><br>Max 100</p>                                                                                                                                                                                                                                                                                       |