# Create Corporation Cardholder

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

`POST` `/issuing/holder/create-corporation`

### **Request Body**

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

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

<table><thead><tr><th width="283.3359375">Name</th><th width="133.0078125">Type</th><th>Description</th></tr></thead><tbody><tr><td>contact_name<mark style="color:red;">*</mark></td><td>string(80)</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.registration_name<mark style="color:red;">*</mark></td><td>string(100)</td><td><p>Registration Name</p><p>Format:<a href="../../../remittance-api/data/dictionary-item/charsets">CHARSETS_7</a></p></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.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><p>The address city</p><p>Format:<a href="../../../remittance-api/data/dictionary-item/charsets">CHARSETS_6</a></p></td></tr><tr><td>corporation.registration_address.state<mark style="color:red;">*</mark></td><td>string(4-48)</td><td><p>The address state</p><p>Format:<a href="../../../remittance-api/data/dictionary-item/charsets">CHARSETS_6</a></p></td></tr><tr><td>corporation.registration_address.country_code<mark style="color:red;">*</mark></td><td>string(2)</td><td><p>Country code,</p><p>refer to <a href="https://docs.pagsmile.com/issuing-card-api/data/dictionary-item/countrycode">CountryCode</a></p></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.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</p><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>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": "CC3B7eD0-6b2d-AbC4-346E-FC8ffA54",
    "timestamp": "2025-04-07 13:52:18",
    "format": "JSON",
    "version": "2.0",
    "sign_type": "RSA",
    "biz_data": {
        "mobile": "+8618102092707",
        "email": "z.yrckcialmy@ccdwqo.to",
        "contact_name": "Test Cjiyzpr",
        "corporation": {
            "registration_name": "Test User INC",
            "registration_code": "360000201510032997",
            "registration_date": "2012-12-10",
            "vat_code": "vatcode12",
            "expires_on": "2032-12-10",
            "business_scope": "test records",
            "registration_address": {
                "city_name": "West Lyda",
                "country_code": "MX",
                "postal_code": "48162-42",
                "state": "Virginia",
                "line": "line 1 line 1 line 1 line 1 ",
                "line2": "line 2 line 2 line 2 line 2 "
            }
        },
        "person": {
            "first_name": "Test",
            "last_name": "User",
            "citizenship_country": "MX",
            "id_type": 2,
            "id_no": "360000200812043160",
            "gender": 3,
            "birthday": "2021-12-09",
            "national_name": "rpc",
            "issuance_date": "2012-12-10",
            "expires_on": "2032-12-10",
            "address": {
                "city_name": "West Ronaldo",
                "country_code": "LR",
                "postal_code": "37993",
                "state": "Tennessee",
                "line": "line 1 line 1 line 1 line 1 ",
                "line2": "line 2 line 2 line 2 line 2 "
            }
        }
    },
    "random_key": "<generated_key>"
}
// The biz_data in this example needs to be encrypted!
```

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

<table><thead><tr><th width="222.60546875">Name</th><th width="138.8828125">Type</th><th>Description</th></tr></thead><tbody><tr><td>holder_id</td><td>long</td><td>Corporation Cardholder ID</td></tr><tr><td>status</td><td>integer</td><td>Status : 0-initial 1-enabled 2-disabled</td></tr></tbody></table>

{% tabs %}
{% tab title="200:OK" %}

```
{
    "code": "10000",
    "msg": "Success",
    "total": 1,
    "random_key": "<random key used for decryption>",
    "sign_type": "RSA",
    "app_id": "00000000000000000",
    "data": {
        "holder_id": 103007,
        "status": 1
    }
}
// The data in this example has already been decrypted.
```

{% endtab %}

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

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

{% endtab %}
{% endtabs %}