Mobile phone number of the merchant or primary contact.
Format: International number including the country calling code.
|
| `email` | string(80) | M | Email address of the merchant or primary contact.
Format: Valid email address.
|
| `business_scenes` | list\ | M | List of integer codes identifying the merchant's business scenes.
Format: List\; submit one or more keys listed in Business Scenes.
Example: \[1005].
|
| `website_url` | string(128) | O | Publicly accessible URL of the merchant's official website.
Format: URL; maximum 128 characters.
|
**Corporation information**
| Field | Type | Requirement | Description |
| ---------------------------------- | ----------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `corporation.corporation_id` | long | M | Pagsmile-assigned unique identifier of the corporation record. |
| `corporation.registration_name` | string(256) | M | Legal name exactly as shown on the official registration documents.
Supports UTF-8/Unicode characters.
No character-set restriction.
Maximum 256 bytes.
|
| `corporation.name_en` | string(128) | M | English name used for bank account applications.
Format: COMPANY\_NAME\_EN; ^\[A-Za-z0-9]\[A-Za-z0-9 .,&'()"/-]\*$.
The first character must be an English letter or digit.
Maximum 128 bytes.
|
| `corporation.industry_category` | string | M | Industry category of the corporation's primary business activity.
Format: String; submit one of the values listed in Industry Category.
|
| `corporation.registration_code` | string(32) | M | Official registration number issued to the corporation by the relevant registration authority.
Maximum length: 32 bytes.
|
| `corporation.registration_country` | string(2) | M | Country in which the corporation is legally registered.
Format: Two-letter ISO 3166-1 alpha-2 country code.
See Country Code for supported values.
|
**Corporation registered address**
| Field | Type | Requirement | Description |
| ----------------------------------------------- | ------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `corporation.registration_address.address_id` | long | M | Pagsmile-assigned unique identifier of the registered-address record to update. |
| `corporation.registration_address.line1` | string(5–128) | M | Primary address line of the corporation's registered office, including the street name and building number.
Format: ADDRESS; 5–128 bytes.
|
| `corporation.registration_address.line2` | string(5–128) | O | Additional registered-address information, such as the unit, suite, floor, or building name.
Format: ADDRESS; when provided, 5–128 bytes.
|
| `corporation.registration_address.postal_code` | string(4-8) | O | ZIP or postal code of the corporation's registered office.
Maximum length: 16 bytes.
|
| `corporation.registration_address.city_name` | string(50) | M | City in which the corporation's registered office is located.
Format: STATE\_CITY; maximum 50 bytes.
|
| `corporation.registration_address.state` | string(50) | O | State, province, or administrative region of the corporation's registered office.
Format: STATE\_CITY; maximum 50 bytes.
|
| `corporation.registration_address.country_code` | string(2) | M | Country of the corporation's registered-office address.
Format: Two-letter ISO 3166-1 alpha-2 country code.
See Country Code for supported values.
|
**Director information**
| Field | Type | Requirement | Description |
| ---------------------- | ------------ | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `director.director_id` | long | M | Pagsmile-assigned unique identifier of the director record. |
| `director.first_name` | string(2–64) | M | Director's legal given name in English or Pinyin, corresponding to the name on the identity document used for verification.
Format: ^\[a-zA-Z-,./ ]+$.
Length: 2–64 characters.
|
| `director.last_name` | string(2–64) | M | Director's legal family name in English or Pinyin, corresponding to the name on the identity document used for verification.
Format: ^\[a-zA-Z-,./ ]+$.
Length: 2–64 characters.
|
| `director.local_name` | string(128) | M | Director's full legal name in the local language, exactly as shown on the identity document used for verification.
Supports UTF-8/Unicode characters.
No character-set restriction.
Maximum 128 bytes.
|
| `director.id_type` | integer | M | Type of identity document submitted for the director.
Format: Integer code.
See ID Type for supported values.
|
| `director.id_no` | string(6-20) | M | Director's identity document number, entered exactly as shown on the document.
Length: 6–18 characters.
|
| `director.nationality` | string(2) | M | Country representing the director's nationality.
Format: Two-letter ISO 3166-1 alpha-2 country code.
See Country Code for supported values.
|
| `director.date_birth` | string | M | Director's date of birth.
Format: yyyy-MM-dd.
|
**Director address**
| Field | Type | Requirement | Description |
| ------------------------------- | ------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `director.address.address_id` | long | M | Pagsmile-assigned unique identifier of the director's residential-address record to update. |
| `director.address.line1` | string(5–128) | M | Primary address line of the director's current residence, including the street name and building number.
Format: ADDRESS; 5–128 bytes.
|
| `director.address.line2` | string(5–128) | O | Additional residential-address information for the director, such as the unit, apartment, floor, or building name.
Format: ADDRESS; when provided, 5–128 bytes.
|
| `director.address.postal_code` | string(4-8) | O | ZIP or postal code of the director's residential address.
Maximum length: 16 bytes.
|
| `director.address.city_name` | string(50) | M | City in which the director currently resides.
Format: STATE\_CITY; maximum 50 bytes.
|
| `director.address.state` | string(50) | O | State, province, or administrative region of the director's residential address.
Format: STATE\_CITY; maximum 50 bytes.
|
| `director.address.country_code` | string(2) | M | Country of the director's residential address.
Format: Two-letter ISO 3166-1 alpha-2 country code.
See Country Code for supported values.
|
**Shareholders**
`shareholders` is an array of UBO records. The field paths below describe each item in the array.
| Field | Type | Requirement | Description |
| ------------------------------- | ------------ | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `shareholders[].shareholder_id` | long | O | Pagsmile-assigned unique identifier of an existing shareholder record.
Omit this field when adding a new shareholder.
|
| `shareholders[].first_name` | string(50) | M | Shareholder's legal given name in English or Pinyin, corresponding to the name on the identity document used for verification.
Format: CHARSETS\_2; 2–64 characters.
See Character Sets for the supported characters.
|
| `shareholders[].last_name` | string(50) | M | Shareholder's legal family name in English or Pinyin, corresponding to the name on the identity document used for verification.
Format: CHARSETS\_2; 2–64 characters.
See Character Sets for the supported characters.
|
| `shareholders[].id_type` | integer | M | Type of identity document submitted for the shareholder.
Format: Integer code.
See ID Type for supported values.
|
| `shareholders[].id_no` | string(6-20) | M | Shareholder's identity document number, entered exactly as shown on the document.
Length: 6–18 characters.
|
| `shareholders[].nationality` | string(2) | M | Country representing the shareholder's nationality.
Format: Two-letter ISO 3166-1 alpha-2 country code.
See Country Code for supported values.
|
**Shareholder address**
| Field | Type | Requirement | Description |
| ------------------------------------- | ------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `shareholders[].address.address_id` | long | O | Pagsmile-assigned unique identifier of the shareholder's residential-address record. |
| `shareholders[].address.line1` | string(5–128) | M | Primary address line of the shareholder's current residence, including the street name and building number.
Format: ADDRESS; 5–128 bytes.
|
| `shareholders[].address.line2` | string(5–128) | O | Additional residential-address information for the shareholder, such as the unit, apartment, floor, or building name.
Format: ADDRESS; when provided, 5–128 bytes.
|
| `shareholders[].address.postal_code` | string(4-8) | O | ZIP or postal code of the shareholder's residential address.
Maximum length: 16 bytes.
|
| `shareholders[].address.city_name` | string(50) | M | City in which the shareholder currently resides.
Format: STATE\_CITY; maximum 50 bytes.
|
| `shareholders[].address.state` | string(50) | O | State, province, or administrative region of the shareholder's residential address.
Format: STATE\_CITY; maximum 50 bytes.
|
| `shareholders[].address.country_code` | string(2) | M | Country of the shareholder's residential address.
Format: Two-letter ISO 3166-1 alpha-2 country code.
See Country Code for supported values.
|
For country values, see [Country Code](https://docs.pagsmile.com/remittance-api/data/dictionary-item/country-code). For character-set restrictions, see [CHARSETS](https://docs.pagsmile.com/remittance-api/data/dictionary-item/charsets).
**`biz_data` example**
The following example shows the business payload before encryption:
```json
{
"merchant_id": 100396,
"mobile": "+5511999999999",
"email": "compliance@example.com",
"business_scenes": [
1005
],
"website_url": "https://example.com",
"corporation": {
"corporation_id": 100450,
"registration_name": "环球旅行有限公司",
"name_en": "517NA TRAVEL AGENCY (HK) LIMITED",
"industry_category": "Online marketplaces",
"registration_code": "BR123456789",
"registration_country": "BR",
"registration_address": {
"address_id": 100850,
"line1": "100 Avenida Paulista",
"line2": "Suite 1200",
"postal_code": "01310100",
"city_name": "Sao Paulo",
"state": "Sao Paulo",
"country_code": "BR"
}
},
"director": {
"director_id": 100474,
"first_name": "Ruth",
"last_name": "Miller",
"local_name": "Ruth Miller",
"id_type": 1,
"id_no": "ABC123456",
"nationality": "BR",
"date_birth": "1988-05-20",
"address": {
"address_id": 100860,
"line1": "200 Rua Augusta",
"line2": "Apartment 15",
"postal_code": "01304000",
"city_name": "Sao Paulo",
"state": "Sao Paulo",
"country_code": "BR"
}
},
"shareholders": [
{
"shareholder_id": 100000,
"first_name": "Jane",
"last_name": "Silva",
"id_type": 1,
"id_no": "XYZ987654",
"nationality": "BR",
"address": {
"address_id": 100870,
"line1": "300 Rua Haddock Lobo",
"line2": "",
"postal_code": "01414001",
"city_name": "Sao Paulo",
"state": "Sao Paulo",
"country_code": "BR"
}
}
]
}
```
**Request example**
```bash
curl --request POST \
--url 'https://rem-api-sandbox.pagsmile.com/remittance/merchant/update-corporation' \
--header 'Content-Type: application/json; charset=UTF-8' \
--data '{
"partner_id": "000000000000001",
"app_id": "162051914172236138",
"timestamp": "2026-07-20 14:30:00",
"version": "2.0",
"language": "en",
"random_key": "",
"request_id": "f6bed39c-eecf-c1a2-afcb-ba9baec80002",
"sign_type": "RSA",
"biz_data": ""
}'
```
{% hint style="info" %}
The sandbox `app_id` shown above is an example. Use the `app_id` assigned to your application when testing.
{% endhint %}
**Response**
{% tabs %}
{% tab title="Success" %}
An accepted update returns HTTP `200` with business code `10000`.
```json
{
"code": "10000",
"msg": "Success"
}
```
{% endtab %}
{% tab title="Invalid signature" %}
An invalid request signature may return HTTP `400` with the following response:
```json
{
"code": "40002",
"msg": "Business Failed",
"sub_code": "invalid-signature",
"sub_msg": "invalid signature"
}
```
{% endtab %}
{% endtabs %}
**Related APIs**
* [Create Corporate Merchant](https://docs.pagsmile.com/remittance-api/business/onboarding/create-corporation)
* [Query Corporate Merchant](https://docs.pagsmile.com/remittance-api/business/onboarding/query-corporation)
* [Remittance API Common](https://docs.pagsmile.com/remittance-api/common)