> 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/create-corporation.md).

# Create Corporate Merchant

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

`POST` `/remittance/merchant/create-corporation`

### **Request Body**

**Refer to :** [**common**](/reference/remittance-api/common.md)

**Biz\_data**

<table><thead><tr><th width="325">Name</th><th>Type</th><th width="228.0703125">Description</th></tr></thead><tbody><tr><td>mobile</td><td>string(16)</td><td>Full mobile phone number, including the country calling code.</td></tr><tr><td>email<mark style="color:red;">*</mark></td><td>string(80)</td><td>Email address of the merchant contact.</td></tr><tr><td>business_category<mark style="color:red;">*</mark></td><td>Integer</td><td>Business category of the merchant. Refer to <a href="/pages/NpxZTDdE0vsJTgws36eV">Business Category</a></td></tr><tr><td>website_url<mark style="color:red;">*</mark></td><td>string(128)</td><td>Website URL of the merchant.</td></tr><tr><td>corporation.registration_name<mark style="color:red;">*</mark></td><td>string(128)</td><td><p>Registered business name of the corporation.</p><p>Format:<a href="/pages/enL04NMTgOzYtcqkOi3b">CHARSETS_7</a></p></td></tr><tr><td>corporation.registration_code<mark style="color:red;">*</mark></td><td>string(32)</td><td>Business registration number of the corporation.</td></tr><tr><td>corporation.business_scope<mark style="color:red;">*</mark></td><td>string(300)</td><td>Description of the corporation's business activities.</td></tr><tr><td>corporation.registration_country<mark style="color:red;">*</mark></td><td>string(2)</td><td>Country where the corporation is registered. Use a 2-letter country code.</td></tr><tr><td>corporation.registration_address.line<mark style="color:red;">*</mark></td><td>string(128)</td><td><p>First line of the corporation's registered address.</p><p>Format:<a href="/pages/enL04NMTgOzYtcqkOi3b">CHARSETS_4</a></p></td></tr><tr><td>corporation.registration_address.line2</td><td>string(128)</td><td><p>Second line of the corporation's registered address.</p><p>Format:<a href="/pages/enL04NMTgOzYtcqkOi3b">CHARSETS_4</a></p></td></tr><tr><td>corporation.registration_address.postal_code</td><td>string(4-16)</td><td>ZIP or postal code of the corporation's registered address.</td></tr><tr><td>corporation.registration_address.city_name<mark style="color:red;">*</mark></td><td>string(4-80)</td><td><p>City of the corporation's registered address.</p><p>Format:<a href="/pages/enL04NMTgOzYtcqkOi3b">CHARSETS_6</a></p></td></tr><tr><td>corporation.registration_address.state</td><td>string(4-48)</td><td><p>State, province, or region of the corporation's registered address.</p><p>Format:<a href="/pages/enL04NMTgOzYtcqkOi3b">CHARSETS_6</a></p></td></tr><tr><td>corporation.registration_address.country_code<mark style="color:red;">*</mark></td><td>string(2)</td><td>Country code of the corporation's registered address. Use a 2-letter country code.</td></tr><tr><td>director.first_name<mark style="color:red;">*</mark></td><td>string(50)</td><td>First name of the director.</td></tr><tr><td>director.last_name<mark style="color:red;">*</mark></td><td>string(50)</td><td>Last name of the director.</td></tr><tr><td>director.id_type<mark style="color:red;">*</mark></td><td>integer</td><td>ID document type of the director. Refer to <a href="/pages/5Tww9Noih9f2JzS5jWAo">ID Type</a></td></tr><tr><td>director.id_no<mark style="color:red;">*</mark></td><td>string(6-20)</td><td>ID document number of the director.</td></tr><tr><td>director.nationality<mark style="color:red;">*</mark></td><td>string(2)</td><td>Nationality of the director. Use a 2-letter country code.</td></tr><tr><td>director.is_pep<mark style="color:red;">*</mark></td><td>Boolean</td><td>Is the director associated with a politically exposed person (PEP)?</td></tr><tr><td>director.address.line<mark style="color:red;">*</mark></td><td>string(128)</td><td><p>First line of the director's residential address.</p><p>Format:<a href="/pages/enL04NMTgOzYtcqkOi3b">CHARSETS_4</a></p></td></tr><tr><td>director.address.line2</td><td>string(128)</td><td><p>Second line of the director's residential address.</p><p>Format:<a href="/pages/enL04NMTgOzYtcqkOi3b">CHARSETS_4</a></p></td></tr><tr><td>director.address.postal_code</td><td>string(4-16)</td><td><p>Director</p><p>ZIP or postal code of the director's residential address.</p></td></tr><tr><td>director.address.city_name<mark style="color:red;">*</mark></td><td>string(4-80)</td><td><p>Director</p><p>The address city</p><p>Format:<a href="/pages/enL04NMTgOzYtcqkOi3b">CHARSETS_6</a></p></td></tr><tr><td>director.address.state</td><td>string(4-64)</td><td><p>State, province, or region of the director's residential address.</p><p>Format:<a href="/pages/enL04NMTgOzYtcqkOi3b">CHARSETS_6</a></p></td></tr><tr><td>director.address.country_code<mark style="color:red;">*</mark></td><td>string(2)</td><td>Country code of the director's residential address. Refer to CountryCode. Use a 2-letter country code. </td></tr><tr><td>shareholders[0].first_name<mark style="color:red;">*</mark></td><td>string(50)</td><td>First name of the UBO.</td></tr><tr><td>shareholders[0].last_name<mark style="color:red;">*</mark></td><td>string(50)</td><td>Last name of the UBO.</td></tr><tr><td>shareholders[0].id_type<mark style="color:red;">*</mark></td><td>integer</td><td><p>ID document type of the UBO. Refer to</p><p><a href="/pages/5Tww9Noih9f2JzS5jWAo">ID Type</a></p></td></tr><tr><td>shareholders[0].id_no<mark style="color:red;">*</mark></td><td>string(6-20)</td><td>ID document number of the UBO.</td></tr><tr><td>shareholders[0].nationality<mark style="color:red;">*</mark></td><td>string(2)</td><td>Nationality of the UBO. Use a 2-letter country code. </td></tr><tr><td>shareholders[0].is_pep<mark style="color:red;">*</mark></td><td>Boolean</td><td>Indicates whether the UBO is associated with a politically exposed person (PEP).</td></tr><tr><td>shareholders[0].address.line<mark style="color:red;">*</mark></td><td>string(128)</td><td>First line of the UBO's residential address.</td></tr><tr><td>shareholders[0].address.line2</td><td>string(128)</td><td>Second line of the UBO's residential address.</td></tr><tr><td>shareholders[0].address.postal_code</td><td>string(4-8)</td><td>ZIP or postal code of the UBO's residential address.</td></tr><tr><td>shareholders[0].address.city_name<mark style="color:red;">*</mark></td><td>string(4-80)</td><td>City of the UBO's residential address.</td></tr><tr><td>shareholders[0].address.state</td><td>string(4-64)</td><td>State, province, or region of the UBO's residential address.</td></tr><tr><td>shareholders[0].address.country_code<mark style="color:red;">*</mark></td><td>string(2)</td><td><p>Country code of the UBO's residential address,</p><p>Use a 2-letter country code. </p></td></tr></tbody></table>

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

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

```
{
    "code": "10000",
    "msg": "Success",
    "data":{
        "merchant_id": 100398，
        "status":1
        
    },
    "random_key":"abssdddd2wdw==",
    "sign_type": "RSA",
    "app_id": "2017051914172236111"
}
```

{% endtab %}

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

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

{% endtab %}
{% endtabs %}

| Name                                           | Type    | Description                                                     |
| ---------------------------------------------- | ------- | --------------------------------------------------------------- |
| merchant\_id<mark style="color:red;">\*</mark> | long    | Merchant ID                                                     |
| status<mark style="color:red;">\*</mark>       | integer | <p>Status :0-initial 1-enabled 2-disabled</p><p>Default : 1</p> |

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

```

curl --location --request POST 'https://rem-api-sandbox.pagsmile.com/remittance/merchant/create-corporation' \
--header 'Content-Type: application/json' \
--data-raw '
{
    "partner_id": "000000000000001",
    "app_id": "162051914172236138",
    "timestamp": "2011-09-23 04:24:03",
    "format": "JSON",
    "version": "2.0",
    "random_key": "jJT3+PR9CSowcR2QOK5OzMjVmTSjGoectzYbO8lENHnboElE",
    "request_id": "F6bEd39c-EecF-C1a2-AFcb-bA9BAeC8",
    "sign_type": "RSA",
    "biz_data":"3+PR9CSowtzYbO8lENHncR2QOK5OzMjJT3+PR9CSowcR2QOK5OzMjVmTSjGoectzYbO8lENHnboElE"
}'
```

```
```

Note: **162\*\*\*\*\*\*\*\*\*\*\*\*38** is pagsmile's test app id for sandbox

Please use your own **app\_id** when testing.