# Getting started

Welcome. This page outlines what it takes to integrate with Nexterpay, from setting up your account to going live in production. Each step links to the detailed guide where you'll find the actual implementation work.

{% hint style="info" %}
Postman Collection [here](#tools-to-help-you-build)
{% endhint %}

{% stepper %}
{% step %}

###  Create your account

Before you can access the API, you'll need a NexterPay merchant account.

Sign up here → <a href="https://nexterpay.io/signup" class="button primary">Sign up Here</a>

Once submitted, our team will review your application and issue your sandbox credentials.

{% endstep %}

{% step %}

### Understand the environments

We have two fully isolated environments:

<table><thead><tr><th width="144.45623779296875">Environment</th><th width="324.140380859375">Base URL</th><th width="199.1961669921875">Use it for</th></tr></thead><tbody><tr><td>Sandbox</td><td><code>https://api-sandbox.nexterpay.io</code></td><td>Building and testing your integration.</td></tr><tr><td>Production</td><td>Issued on approval</td><td>Live transactions.</td></tr></tbody></table>

Sandbox and production credentials are separate. Test thoroughly in sandbox before requesting production access.

{% endstep %}

{% step %}

### Authenticate

Every API request requires a Bearer token. You'll generate one by exchanging your credentials.

{% content-ref url="/pages/5H9UML9WXnwgIgAzRRek" %}
[Authentication](/authentication.md)
{% endcontent-ref %}

{% endstep %}

{% step %}

### Learn the core concepts

Spend a few minutes understanding how NexterPay structures transactions - `externalID`, `orderID`, `senderID`, and the transaction lifecycle. This saves hours during integration.

{% content-ref url="/pages/MkUPkI77aUCMR9x4qyzv" %}
[Key concepts](/core-concepts.md)
{% endcontent-ref %}

{% endstep %}

{% step %}

### Build your integration

Pick the flow that matches your use case:

* **Collecting payments?** →  [Payin](/payin/payin-overview.md)
* **Sending payouts?** →  [PayOut](/payout/payout-overview.md)
* **Doing both**? Start with PayIn, then layer in PayOut

{% endstep %}

{% step %}

### Go live

When your integration is fully tested in sandbox:

1. Reach out to your NexterPay contact to request production access.
2. We'll review your integration and issue production credentials.
3. Update your environment URLs and credentials.
4. Start processing live transactions.
   {% endstep %}
   {% endstepper %}

***

### Tools to help you build

* **Postman collection** - every endpoint pre-configured.&#x20;

{% embed url="<https://www.postman.com/tam-a04f53f0-999597/nexterpay-public-api/collection/29ph8vk/nexterpay-payout-sandbox?sideView=agentMode&tab=variables>" %}

* **Swagger UI - API collection and Documentation**

{% embed url="<https://api-sandbox.nexterpay.io/Swagger/index.html?urls.primaryName=Authentication>" %}

***

### Need help?

Your dedicated NexterPay contact is your fastest support route during integration.

You can also send an email to <tam@nexterpay.io>


---

# Agent Instructions: 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.nexterpay.io/getting-started.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.