> For the complete documentation index, see [llms.txt](https://docs.pagsmile.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pagsmile.com/reference/remittance-api/business/onboarding/update-individual.md).
# Update Individual
Updates the identity, contact, and residential address information of an existing individual merchant.
#### Endpoint
`POST /remittance/merchant/update-individual`
**Sandbox base URL:** `https://rem-api-sandbox.pagsmile.com`\
**Content-Type:** `application/json; charset=UTF-8`
The request uses the standard [Remittance API request envelope](https://docs.pagsmile.com/remittance-api/common). The fields below describe the decrypted `biz_data` object.
{% hint style="info" %}
**Requirement:** `M` = Mandatory, `O` = Optional, and `C` = Conditional. A conditional field is mandatory only when the condition stated in its description applies.
{% endhint %}
{% hint style="warning" %}
Encrypt `biz_data`, encrypt the AES key into `random_key`, and sign the request according to the Common request specification.
{% endhint %}
#### Request body
**Decrypted `biz_data` fields**
| Field | Type | Requirement | Description |
| ---------------------- | -------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `merchant_id` | long | M | Pagsmile-assigned unique identifier of the merchant on whose behalf the request is submitted. |
| `mobile` | string(16) | M | Full mobile phone number, including the international country calling code. |
| `first_name` | string(50) | M | Legal first name of the individual. |
| `last_name` | string(50) | M | Legal last name of the individual. |
| `id_no` | string(6-20) | M | Number of the identity document. |
| `id_type` | integer | M | Type of identity document used for identity verification.
See Type of certificate. for supported values.
|
| `issuance_date` | string | O | Issue date of the identity document. Format: `yyyy-MM-dd`. |
| `expires_on` | string | O | Expiration date of the identity document. Format: `yyyy-MM-dd`. |
| `email` | string | M | Email address of the merchant or contact person. |
| `birthday` | string | M | Date of birth of the individual. Format: `yyyy-MM-dd`. |
| `gender` | integer | M | Gender of the individual merchant.
See Gender for supported values.
|
| `nationality_code` | string(2) | M | Two-letter ISO 3166-1 alpha-2 code representing the individual's nationality.
See CountryCode for supported values.
|
| `address.address_id` | long | M | Unique identifier of the address. |
| `address.line` | string(12-128) | M | First line of the individual's residential address.
Format: CHARSETS\_4.
|
| `address.line2` | string(128) | O | Optional second line of the individual's residential address.
Format: CHARSETS\_4.
|
| `address.postal_code` | string(4-8) | M | ZIP or postal code of the individual's residential address. |
| `address.city_name` | string(4-80) | M | City of the individual's residential address.
Format: CHARSETS\_6.
|
| `address.state` | string(4-48) | M | State, province, or region of the individual's residential address.
Format: CHARSETS\_6.
|
| `address.country_code` | string(2) | M | Two-letter ISO 3166-1 alpha-2 country code of the individual's residential address. |
**Plaintext `biz_data` example**
{% hint style="info" %}
This example includes mandatory fields and representative optional or conditional fields. Submit fields marked `C` only when the condition in the field description applies.
{% endhint %}
```json
{
"merchant_id": 100398,
"mobile": "+5511999999999",
"first_name": "Example Name",
"last_name": "Example Name",
"id_no": "AB123456789",
"id_type": 1,
"issuance_date": "2026-07-20",
"expires_on": "2026-07-20",
"email": "merchant@example.com",
"birthday": "1990-01-01",
"gender": 1,
"nationality_code": "BR",
"address": {
"address_id": 100001,
"line": "100 Avenida Paulista",
"line2": "100 Avenida Paulista",
"postal_code": "01310-100",
"city_name": "Example Name",
"state": "SP",
"country_code": "BR"
}
}
```
#### Request example
```bash
curl --request POST \
--url https://rem-api-sandbox.pagsmile.com/remittance/merchant/update-individual \
--header 'Content-Type: application/json; charset=UTF-8' \
--data '{
"partner_id": "",
"app_id": "",
"timestamp": "2026-07-20 10:30:00",
"version": "2.0",
"language": "en",
"random_key": "",
"request_id": "",
"sign_type": "RSA",
"biz_data": ""
}'
```
{% hint style="info" %}
Use the `partner_id` and `app_id` assigned to your integration. The values above are placeholders.
{% endhint %}
#### Response
{% tabs %}
{% tab title="Success" %}
```json
{
"code": "10000",
"msg": "Success"
}
```
{% endtab %}
{% tab title="Invalid signature" %}
```json
{
"code": "40002",
"msg": "Business Failed",
"sub_code": "invalid-signature",
"sub_msg": "invalid signature"
}
```
{% endtab %}
{% endtabs %}
#### Related APIs
* [Add Shop](https://docs.pagsmile.com/remittance-api/business/onboarding/add-shop)
* [Create Corporate Merchant](https://docs.pagsmile.com/remittance-api/business/onboarding/create-corporation)
* [Create Individual](https://docs.pagsmile.com/remittance-api/business/onboarding/create-individual)
* [Delete Shop](https://docs.pagsmile.com/remittance-api/business/onboarding/delete-shop)
* [Query Corporate Merchant](https://docs.pagsmile.com/remittance-api/business/onboarding/query-corporation)
* [Query Individual](https://docs.pagsmile.com/remittance-api/business/onboarding/query-individual)
* [Query Shops](https://docs.pagsmile.com/remittance-api/business/onboarding/query-shops)
* [Update Corporate Merchant](https://docs.pagsmile.com/remittance-api/business/onboarding/update-corporation)