> For the complete documentation index, see [llms.txt](https://docs.neox.vn/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.neox.vn/docs/global/global-collections/integration/how-to-register.md).

# How To Register

Before calling any Global Collections API, the Merchant must activate the service and obtain API credentials on the Merchant Portal.

**Step 1:** Log in to the Merchant Portal.

**Step 2:** On the right pane, choose the **Global Collections service**, click the **START REGISTRATION** button, then click **SUBMIT** on the confirmation popup.

**Step 3:** Complete the Merchant KYB review. NeoX (with the partner provider) verifies the master merchant before the service is enabled.

**Step 4:** Retrieve the API integration credentials.

* Open the **Profile** section on the Merchant Portal.
* Copy the **client\_id** and **client\_secret** — these are used by the [API authenPlatform](/docs/global/global-collections/integration/api-authenplatform.md) endpoint to obtain a Bearer token.

**Step 5:** Configure the webhook to receive event notifications (recommended).

* Enable **Use APIs**.
* Fill in the **URL to receive notifications** for Global Collections events.
* Fill in the **Secret Key** — used to verify the `secureHash` of each webhook payload.
* Select the event **Type(s)** to subscribe to. See [Event Notification](/docs/global/global-collections/integration/event-notification.md).

**Step 6:** Generate the encryption key pair for sensitive payloads (if applicable).

* Generate an RSA key pair and upload the **public key** on the Merchant Portal.
* Keep the **private key** secret — it is used to decrypt any sensitive data returned by the service.

Once the service is **ACTIVE** and credentials are issued, proceed to [Security Method](/docs/global/global-collections/integration/security-method.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.neox.vn/docs/global/global-collections/integration/how-to-register.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
