> 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/query-corporation.md). # Query Corporate Merchant {% hint style="info" %} Pass the `merchant_id` returned by [Create Corporate Merchant](https://docs.pagsmile.com/remittance-api/business/onboarding/create-corporation). The response can be used to review the profile before submitting an update. {% endhint %} **Endpoint** `POST /remittance/merchant/query-corporation` **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 table below describes 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 %} **Request body** | Field | Type | Requirement | Description | | ------------- | ---- | ----------- | ---------------------------------------------------- | | `merchant_id` | long | M | Pagsmile-assigned unique identifier of the merchant. | **Plaintext `biz_data` example** ```json { "merchant_id": 100398 } ``` **Request example** ```bash curl --request POST \ --url https://rem-api-sandbox.pagsmile.com/remittance/merchant/query-corporation \ --header 'Content-Type: application/json; charset=UTF-8' \ --data '{ "partner_id": "200000001000001", "app_id": "2020123456789012345", "timestamp": "2026-07-20 10:35:00", "version": "2.0", "language": "en", "random_key": "", "request_id": "f6bed39c-eecf-c1a2-afcb-ba9baec80003", "sign_type": "RSA", "biz_data": "" }' ``` {% hint style="info" %} The sandbox `app_id` shown above is an example. Use the `app_id` assigned to your application when testing. {% endhint %} **Response** {% tabs %} {% tab title="Success" %} A successful query returns HTTP `200` with business code `10000`. The `data` field in the response envelope is AES-encrypted. Decrypt `random_key` with your RSA private key, then use the resulting AES key to decrypt `data`. See [Security](https://docs.pagsmile.com/remittance-api/security) for implementation details. **Encrypted response example** ```json { "code": "10000", "msg": "Success", "data": "", "random_key": "", "sign_type": "RSA", "app_id": "2020123456789012345" } ``` **Decrypted `data` example** ```json { "merchant_id": 100398, "mobile": "+5511999999999", "email": "operations@example.com", "business_scenes": [ 1005 ], "website_url": "https://www.example.com", "corporation": { "corporation_id": 200512, "registration_name": "环球旅行有限公司", "name_en": "517NA TRAVEL AGENCY (HK) LIMITED", "industry_category": "Online marketplaces", "registration_code": "12345678000199", "registration_country": "BR", "registration_address": { "line1": "100 Avenida Paulista", "line2": "10th Floor", "postal_code": "01310-100", "city_name": "Sao Paulo", "state": "SP", "country_code": "BR" } }, "director": { "director_id": 300624, "first_name": "Ana", "last_name": "Silva", "local_name": "Ana Silva", "id_type": 1, "id_no": "12345678901", "nationality": "BR", "date_birth": "1988-05-20", "address": { "line1": "200 Rua Augusta", "line2": "Apartment 12", "postal_code": "01304-000", "city_name": "Sao Paulo", "state": "SP", "country_code": "BR" } }, "shareholders": [ { "shareholder_id": 400736, "first_name": "Carlos", "last_name": "Santos", "id_type": 1, "id_no": "98765432100", "nationality": "BR", "address": { "line1": "300 Rua Haddock Lobo", "line2": "Suite 5", "postal_code": "01414-000", "city_name": "Sao Paulo", "state": "SP", "country_code": "BR" } } ], "status": 1, "created_at": "2026-07-20 10:30:00" } ``` {% endtab %} {% tab title="Invalid signature" %} An invalid request signature may return HTTP `400` with the following response: ```json { "code": "40002", "msg": "Business Failed", "sub_code": "invalid-signature", "sub_msg": "invalid signature" } ``` {% endtab %} {% endtabs %} **Response data fields** The `data` object contains the corporate merchant profile described below. **Merchant information** | Field | Type | Requirement | Description | | ----------------- | -------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `merchant_id` | long | M | Pagsmile-assigned unique identifier of the merchant associated with the returned record. | | `mobile` | string(16) | O |

Mobile phone number of the merchant or primary contact.
Format: International number including the country calling code.

Email address of the merchant or primary contact.
Format: Valid email address.

List of integer codes identifying the merchant's business scenes.
Format: List\; submit one or more keys listed in Business Scenes.
Example: \[1005].

Publicly accessible URL of the merchant's official website.
Format: URL; maximum 128 characters.

Current lifecycle status of the corporate merchant profile.
Supported values: TBC before publication.

Date and time when the corporate merchant profile was created.
Format: yyyy-MM-dd HH:mm:ss.

| **Corporation information** | Field | Type | Requirement | Description | | ---------------------------------- | ----------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `corporation.corporation_id` | long | M | Pagsmile-assigned unique identifier of the corporation record. | | `corporation.registration_name` | string(256) | M |

Legal name exactly as shown on the official registration documents.
Supports UTF-8/Unicode characters.
No character-set restriction.
Maximum 256 bytes.

English name used for bank account applications.
Format: COMPANY\_NAME\_EN; ^\[A-Za-z0-9]\[A-Za-z0-9 .,&'()"/-]\*$.
The first character must be an English letter or digit.
Maximum 128 bytes.

Industry category of the corporation's primary business activity.
Format: String; submit one of the values listed in Industry Category.

Official registration number issued to the corporation by the relevant registration authority.
Maximum length: 32 bytes.

Country in which the corporation is legally registered.
Format: Two-letter ISO 3166-1 alpha-2 country code.
See Country Code for supported values.

| **Registered address** | Field | Type | Requirement | Description | | ----------------------------------------------- | ------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `corporation.registration_address.line1` | string(5–128) | M |

Primary address line of the corporation's registered office, including the street name and building number.
Format: ADDRESS; 5–128 bytes.

Additional registered-address information, such as the unit, suite, floor, or building name.
Format: ADDRESS; when provided, 5–128 bytes.

ZIP or postal code of the corporation's registered office.
Maximum length: 16 bytes.

City in which the corporation's registered office is located.
Format: STATE\_CITY; maximum 50 bytes.

State, province, or administrative region of the corporation's registered office.
Format: STATE\_CITY; maximum 50 bytes.

Country of the corporation's registered-office address.
Format: Two-letter ISO 3166-1 alpha-2 country code.
See Country Code for supported values.

| **Director information** | Field | Type | Requirement | Description | | ---------------------- | ------------ | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `director.director_id` | long | M | Pagsmile-assigned unique identifier of the director record. | | `director.first_name` | string(2–64) | M |

Director's legal given name in English or Pinyin, corresponding to the name on the identity document used for verification.
Format: ^\[a-zA-Z-,./ ]+$.
Length: 2–64 characters.

Director's legal family name in English or Pinyin, corresponding to the name on the identity document used for verification.
Format: ^\[a-zA-Z-,./ ]+$.
Length: 2–64 characters.

Director's full legal name in the local language, exactly as shown on the identity document used for verification.
Supports UTF-8/Unicode characters.
No character-set restriction.
Maximum 128 bytes.

Type of identity document submitted for the director.
Format: Integer code.
See ID Type for supported values.

Director's identity document number, entered exactly as shown on the document.
Length: 6–18 characters.

Country representing the director's nationality.
Format: Two-letter ISO 3166-1 alpha-2 country code.
See Country Code for supported values.

Director's date of birth.
Format: yyyy-MM-dd.

| **Director address** | Field | Type | Requirement | Description | | ------------------------------- | ------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `director.address.line1` | string(5–128) | M |

Primary address line of the director's current residence, including the street name and building number.
Format: ADDRESS; 5–128 bytes.

Additional residential-address information for the director, such as the unit, apartment, floor, or building name.
Format: ADDRESS; when provided, 5–128 bytes.

ZIP or postal code of the director's residential address.
Maximum length: 16 bytes.

City in which the director currently resides.
Format: STATE\_CITY; maximum 50 bytes.

State, province, or administrative region of the director's residential address.
Format: STATE\_CITY; maximum 50 bytes.

Country of the director's residential address.
Format: Two-letter ISO 3166-1 alpha-2 country code.
See Country Code for supported values.

| **Shareholder information** `shareholders` is an array containing the merchant's UBO or shareholder records. | Field | Type | Requirement | Description | | ------------------------------- | ------------ | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `shareholders[].shareholder_id` | long | O | Pagsmile-assigned unique identifier of the shareholder record. | | `shareholders[].first_name` | string(50) | M |

Shareholder's legal given name in English or Pinyin, corresponding to the name on the identity document used for verification.
Format: CHARSETS\_2; 2–64 characters.
See Character Sets for the supported characters.

Shareholder's legal family name in English or Pinyin, corresponding to the name on the identity document used for verification.
Format: CHARSETS\_2; 2–64 characters.
See Character Sets for the supported characters.

Type of identity document submitted for the shareholder.
Format: Integer code.
See ID Type for supported values.

Shareholder's identity document number, entered exactly as shown on the document.
Length: 6–18 characters.

Country representing the shareholder's nationality.
Format: Two-letter ISO 3166-1 alpha-2 country code.
See Country Code for supported values.

| **Shareholder address** | Field | Type | Requirement | Description | | ------------------------------------- | ------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `shareholders[].address.line1` | string(5–128) | M |

Primary address line of the shareholder's current residence, including the street name and building number.
Format: ADDRESS; 5–128 bytes.

Additional residential-address information for the shareholder, such as the unit, apartment, floor, or building name.
Format: ADDRESS; when provided, 5–128 bytes.

City in which the shareholder currently resides.
Format: STATE\_CITY; maximum 50 bytes.

State, province, or administrative region of the shareholder's residential address.
Format: STATE\_CITY; maximum 50 bytes.

| | `shareholders[].address.country_code` | string(2) | M | Two-letter ISO 3166-1 alpha-2 country code of the shareholder's residential address. | **Related APIs** * [Create Corporate Merchant](https://docs.pagsmile.com/remittance-api/business/onboarding/create-corporation) * [Update Corporate Merchant](https://docs.pagsmile.com/remittance-api/business/onboarding/update-corporation) * [Remittance API Common](https://docs.pagsmile.com/remittance-api/common)