> For the complete documentation index, see [llms.txt](https://pivot-payment.gitbook.io/pivot-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pivot-payment.gitbook.io/pivot-docs/api-references/api-lists/payout-international/sender/update-sender.md).

# Update Sender

## Method and URL

<mark style="color:green;">`PUT`</mark> \[<mark style="color:orange;">BASE\_URL</mark>]/xb/sender/:id

## **Request Params**

**Request body**

```json
{
    "name": "Indonesah Newjeans",
    "countryCode": "ID",
    "state": "Jawa Barat",
    "city": "Bandung",
    "address": "Jl Street",
    "postcode": "12345",
    "accountType": "Individual",
    "dob": "1990-12-01", //conditional, only for individual
    "bankAccountNumber": "98723293", //conditional, only for beneficiary country Korea
    "identificationType": "Passport",
    "identificationNumber": "X123457",
    "contactCountryCode": "+62",
    "contactNumber": "123134123",
    "sourceOfIncome": "Salary"
}
```

## Response

**Response Body**

```json
{
    "code": "00",
    "message": "Success",
    "data": {
        "uuid": "da9fb196-3f8f-4bb7-a838-c50c40d13581",
        "name": "Indonesah Newjeans",
        "countryCode": "ID",
        "state": "Jawa Barat",
        "city": "Bandung",
        "address": "Jl Street",
        "postcode": "12345",
        "accountType": "Individual",
        "identificationType": "Passport",
        "identificationNumber": "X123457",
        "bankAccountNumber": "98723293",
        "dob": "1990-12-01",
        "contactCountryCode": "+62",
        "contactNumber": "123134123",
        "sourceOfIncome": "Salary",
        "createdAt": "2024-11-06T03:10:25Z"
    }
}

```

**Sender Object**

<table><thead><tr><th>Parameter</th><th width="220">Data Type</th><th>Requirement</th><th>Description</th></tr></thead><tbody><tr><td>uuid</td><td>String Generated</td><td>M</td><td>Object unique identifier</td></tr><tr><td>merchantId</td><td>String Generated</td><td>M</td><td>Merchant unique identifier</td></tr><tr><td>referenceId</td><td>String</td><td>M</td><td>Merchant remitter reference ID</td></tr><tr><td>name</td><td>String <br></td><td>M</td><td><p>Remitter name<br>^[A-Za-z0-9 -]{1,40}$</p><p><br></p><p>Max 40</p><p>Can only contain the special characters</p></td></tr><tr><td>countryCode</td><td>Enum </td><td>M</td><td>Remitter two-letter country code based on ISO 3166-1</td></tr><tr><td>state</td><td>String</td><td>M</td><td>Remitter state<br>Length: Max 255</td></tr><tr><td>city</td><td>String</td><td>M</td><td>Remitter city<br>Length: Max 35</td></tr><tr><td>address</td><td>String</td><td>M</td><td>Remitter address<br><br>Length: Max 200</td></tr><tr><td>postcode</td><td>Number </td><td>M</td><td><p>Remitter postcode<br><br>^[a-zA-Z0-9\s\-]{0,16}$</p><p><br></p><p>Max 16</p><p>Can only contain the special characters -</p></td></tr><tr><td>accountType</td><td>Enum </td><td>M</td><td><p>Remitter account type (individual or company)<br><br></p><p>Value:</p><p>Should be either</p><ul><li>Individual</li><li>Company</li></ul></td></tr><tr><td>bankAccountNumber</td><td>String</td><td>C<br>Required if beneficiary country code is KR</td><td><p>Remitter bank name</p><p><br><br>Length: Max 50</p></td></tr><tr><td>nationality</td><td>Enum </td><td>M</td><td><p>Remitter nationality in two-letter country code based on ISO 3166-1<br></p><p>Value: Can be the same as remitterCountryCode</p></td></tr><tr><td>identificationType</td><td><p>Enum</p><p></p></td><td>M</td><td><p>Remitter ID type according to account type<br><br></p><p>Value:</p><p>If Individual, should be either</p><ul><li>Kartu Tanda Penduduk</li><li>Passport</li></ul><p><br></p><p>If Company, should be either</p><ul><li>Business Registration Number</li><li>ACRA</li><li>Travel Agent License Number</li><li>ABN</li><li>ACN</li><li>ARBN</li></ul></td></tr><tr><td>identificationNumber</td><td>String </td><td>M</td><td><p>Remitter ID number based on the ID type selected<br><br>^[A-Za-z0-9\s-.]{1,30}$</p><p><br></p><p>Max 30</p><p>Can only contain the special characters </p></td></tr><tr><td>dob</td><td>String </td><td>C</td><td><p>Remitter date of birth</p><p>Required if account type is Individual</p><p></p><p>Format: YYYY/MM/DD</p></td></tr><tr><td>contactCountryCode</td><td>String</td><td>M</td><td>Remitter contact country code<br><br>Length: Max 5</td></tr><tr><td>contactNumber</td><td>String </td><td>M</td><td><p>Remitter contact number<br></p><p>^[0-9+/-\\s]{0,17}$<br></p><p>Length: Max 17</p></td></tr><tr><td>sourceOfIncome</td><td>Enum </td><td>M</td><td><p>Remitter source of income<br><br></p><p>Value:</p><p>Should be either</p><ul><li>Salary</li><li>Personal Savings</li><li>Personal Wealth</li><li>Retirement Funds</li><li>Business Owner</li><li>Shareholder</li><li>Loan Facility</li><li>Personal Account</li><li>Corporate Account</li></ul></td></tr></tbody></table>
