# Update Corporation Cardholder

### **Request URI** <a href="#payin-by-creditcard" id="payin-by-creditcard"></a>

`POST` `/issuing/holder/update-corporation`

### **Request Body**

&#x20;**Refer to :** [**common**](https://docs.pagsmile.com/issuing-card-api/common)

&#x20;**Biz\_data :**

<table><thead><tr><th width="268.05859375">Name</th><th width="139.984375">Type</th><th>Description</th></tr></thead><tbody><tr><td>holder_id<mark style="color:red;">*</mark></td><td>long</td><td>Corporation Holder ID</td></tr><tr><td>contact_name<mark style="color:red;">*</mark></td><td>string(100)</td><td>Contact Name</td></tr><tr><td>mobile<mark style="color:red;">*</mark></td><td>string(16)</td><td><p>The whole mobile phone number.</p><p>Need to add an international area code</p></td></tr><tr><td>email<mark style="color:red;">*</mark></td><td>string(80)</td><td>Email</td></tr><tr><td>corporation.corporation_id<mark style="color:red;">*</mark></td><td>long</td><td>Corporation ID</td></tr><tr><td>corporation.registration_name<mark style="color:red;">*</mark></td><td>string(100)</td><td>Registration Name.Format:<a href="../../../remittance-api/data/dictionary-item/charsets">CHARSETS_7</a></td></tr><tr><td>corporation.registration_code<mark style="color:red;">*</mark></td><td>string(32)</td><td>Registration Code</td></tr><tr><td>corporation.registration_date<mark style="color:red;">*</mark></td><td>string(20)</td><td>Registration Date.Format: yyyy-MM-dd</td></tr><tr><td>corporation.vat_code</td><td>string(32)</td><td>VAT Code</td></tr><tr><td>corporation.expires_on</td><td>string(20)</td><td>Expires On.Format: yyyy-MM-dd</td></tr><tr><td>corporation.business_scope</td><td>string(300)</td><td>Business Scope</td></tr><tr><td>corporation.registration_address.address_id<mark style="color:red;">*</mark></td><td>long</td><td>Address ID</td></tr><tr><td>corporation.registration_address.line<mark style="color:red;">*</mark></td><td>string(128)</td><td><p>The first line of the address.</p><p>Format:<a href="../../../remittance-api/data/dictionary-item/charsets">CHARSETS_4</a></p></td></tr><tr><td>corporation.registration_address.line2</td><td>string(128)</td><td><p>The second line of the address.</p><p>Format:<a href="../../../remittance-api/data/dictionary-item/charsets">CHARSETS_4</a></p></td></tr><tr><td>corporation.registration_address.postal_code<mark style="color:red;">*</mark></td><td>string(4-8)</td><td>The address zip code, or postal code</td></tr><tr><td>corporation.registration_address.city_name<mark style="color:red;">*</mark></td><td>string(4-80)</td><td>The address city.Format:<a href="../../../remittance-api/data/dictionary-item/charsets">CHARSETS_6</a></td></tr><tr><td>corporation.registration_address.state<mark style="color:red;">*</mark></td><td>string(4-48)</td><td>The address state.Format:<a href="../../../remittance-api/data/dictionary-item/charsets">CHARSETS_6</a></td></tr><tr><td>corporation.registration_address.country_code<mark style="color:red;">*</mark></td><td>string(2)</td><td>Country code.Refer to <a href="https://docs.pagsmile.com/issuing-card-api/data/dictionary-item/countrycode">CountryCode</a></td></tr><tr><td>person.person_id<mark style="color:red;">*</mark></td><td>long</td><td>Person ID</td></tr><tr><td>person.first_name<mark style="color:red;">*</mark></td><td>string(50)</td><td>Director.First Name</td></tr><tr><td>person.last_name<mark style="color:red;">*</mark></td><td>string(50)</td><td>Director.Last Name</td></tr><tr><td>person.middle_name</td><td>string(50)</td><td>Director.Middle Name</td></tr><tr><td>person.national_name</td><td>string(50)</td><td>Director.National Name</td></tr><tr><td>person.id_type<mark style="color:red;">*</mark></td><td>integer</td><td>Director.<a href="../../../remittance-api/data/dictionary-item/id-type">ID Type</a></td></tr><tr><td>person.id_no<mark style="color:red;">*</mark></td><td>string(6-20)</td><td>Director.ID Number</td></tr><tr><td>person.birthday<mark style="color:red;">*</mark></td><td>string(20)</td><td><p>Director.Birthday</p><p>Format: yyyy-MM-dd</p></td></tr><tr><td>person.issuance_date</td><td>string(20)</td><td><p>Director.Issuance Date</p><p>Format: yyyy-MM-dd</p></td></tr><tr><td>person.expires_on</td><td>string(20)</td><td><p>Director.Expires On</p><p>Format: yyyy-MM-dd</p></td></tr><tr><td>person.citizenship_country<mark style="color:red;">*</mark></td><td>string(2)</td><td>Director.Citizenship Country</td></tr><tr><td>person.address.address_id<mark style="color:red;">*</mark></td><td>long</td><td>Address ID</td></tr><tr><td>person.address.line<mark style="color:red;">*</mark></td><td>string(128)</td><td><p>Director.The first line of the address.</p><p>Format:<a href="../../../remittance-api/data/dictionary-item/charsets">CHARSETS_4</a></p></td></tr><tr><td>person.address.line2</td><td>string(128)</td><td><p>Director.The second line of the address.</p><p>Format:<a href="../../../remittance-api/data/dictionary-item/charsets">CHARSETS_4</a></p></td></tr><tr><td>person.address.postal_code<mark style="color:red;">*</mark></td><td>string(4-8)</td><td><p>Director</p><p>The address zip code, or postal code</p></td></tr><tr><td>person.address.city_name<mark style="color:red;">*</mark></td><td>string(4-80)</td><td><p>Director.The address city</p><p>Format:<a href="../../../remittance-api/data/dictionary-item/charsets">CHARSETS_6</a></p></td></tr><tr><td>person.address.state<mark style="color:red;">*</mark></td><td>string(4-48)</td><td><p>Director.The address state</p><p>Format:<a href="../../../remittance-api/data/dictionary-item/charsets">CHARSETS_6</a></p></td></tr><tr><td>person.address.country_code<mark style="color:red;">*</mark></td><td>string(2)</td><td><p>Director.Country code</p><p>Refer to <a href="https://docs.pagsmile.com/issuing-card-api/data/dictionary-item/countrycode">CountryCode</a></p></td></tr></tbody></table>

### **Request** Example <a href="#example" id="example"></a>

```
{
    "app_id": "00000000000000000",
    "partner_id": "00000000000000000",
    "request_id": "CC9A9cE2-57E7-fF1b-d5E0-2fC96A02",
    "timestamp": "2025-04-07 13:52:21",
    "format": "JSON",
    "version": "2.0",
    "sign_type": "RSA",
    "biz_data": {
        "holder_id": 103007,
        "mobile": "+8613325862723",
        "email": "q.ltzolmd@bfmy.us",
        "contact_name": "Api Smoke Ceshyjb",
        "corporation": {
            "corporation_id": 100817,
            "registration_name": "API SMOKE PENGUIN INC CHANGED",
            "registration_code": "64000019850408614X",
            "registration_date": "2012-12-10",
            "vat_code": "vatcode12",
            "expires_on": "2032-12-10",
            "business_scope": "automation test records",
            "registration_address": {
                "address_id": 104344,
                "city_name": "Vedachester",
                "country_code": "MX",
                "postal_code": "78995-04",
                "state": "Utah",
                "line": "3052 Braun Lakes",
                "line2": "Suite 675"
            }
        },
        "person": {
            "person_id": 103260,
            "first_name": "Api Smoke",
            "last_name": "Ceezfgw",
            "citizenship_country": "MX",
            "id_type": 2,
            "id_no": "460000197404194137",
            "gender": 2,
            "birthday": "2021-12-09",
            "national_name": "rpc",
            "issuance_date": "2012-12-10",
            "expires_on": "2032-12-10",
            "address": {
                "address_id": 104343,
                "city_name": "Alexandraburgh",
                "country_code": "NP",
                "postal_code": "21154",
                "state": "Wyoming",
                "line": "46467 Kamron Tunnel",
                "line2": "Apt. 886"
            }
        }
    },
    "random_key": "<generated_key>"
}
// The biz_data in this example needs to be encrypted!
```

### Response <a href="#example" id="example"></a>

{% tabs %}
{% tab title="200:submit successfully" %}

```
{
    "code": "10000",
    "msg": "Success"
}
```

{% endtab %}

{% tab title="400: invalid-signature" %}

```
{
    "code": "40002",
    "msg": "Business Failed",
    "sub_code": "invalid-signature",
    "sub_msg": "invalid signature"
}
```

{% endtab %}
{% endtabs %}