# Welcome to conomy\_hq

Build and operate account + payment flows with a single API surface for:

* Identity and organization management
* Multi-rail pay-ins and payouts
* Account lifecycle and balances
* Checkout sessions, payment links, and webhooks

{% hint style="info" %}
Start in `sandbox`, then move to production credentials once your integration and webhook flow are validated.
{% endhint %}

## Environments

{% tabs %}
{% tab title="🧪 Sandbox" %}
Use sandbox for development, test payments, and webhook handling.

```bash
https://api.conomyhq.com/sandbox
```

{% endtab %}

{% tab title="🚀 Production" %}
Switch once your credentials, idempotency, and webhook verification are ready.

```bash
https://api.conomyhq.com
```

{% endtab %}
{% endtabs %}

## Integrate in 4 Steps

{% columns fullWidth="true" %}
{% column %}
{% content-ref url="../quickstart/obtain-an-access-token" %}
[obtain-an-access-token](https://developers.conomyhq.com/quickstart/obtain-an-access-token)
{% endcontent-ref %}
{% endcolumn %}

{% column %}
{% content-ref url="../quickstart/create-an-organization" %}
[create-an-organization](https://developers.conomyhq.com/quickstart/create-an-organization)
{% endcontent-ref %}
{% endcolumn %}
{% endcolumns %}

{% columns fullWidth="true" %}
{% column %}
{% content-ref url="../quickstart/create-accounts" %}
[create-accounts](https://developers.conomyhq.com/quickstart/create-accounts)
{% endcontent-ref %}
{% endcolumn %}

{% column %}
{% content-ref url="../quickstart/create-your-first-top-up" %}
[create-your-first-top-up](https://developers.conomyhq.com/quickstart/create-your-first-top-up)
{% endcontent-ref %}
{% endcolumn %}
{% endcolumns %}

## Common Workflows

{% tabs %}
{% tab title="⬇️ Collect funds (pay-in)" %}
Use external rails (`PIX`, `ETPAY`, `PSE`, `CARD`, etc.) as origin and settle into internal `ACCOUNT` destinations.

{% content-ref url="../payments/payment-types/topup-account" %}
[topup-account](https://developers.conomyhq.com/payments/payment-types/topup-account)
{% endcontent-ref %}
{% endtab %}

{% tab title="⬆️ Send funds (pay-out)" %}
Use internal `ACCOUNT` origins and external rails (`BANK_ACCOUNT`, `SPEI`, `ACH`, `SWIFT`, etc.) as destinations.

{% content-ref url="../payments/payment-types/withdrawal-account" %}
[withdrawal-account](https://developers.conomyhq.com/payments/payment-types/withdrawal-account)
{% endcontent-ref %}
{% endtab %}

{% tab title="🧾 Charge customers" %}
Use `PURCHASE` with checkout/payment-link flows and webhook-driven lifecycle updates.

{% content-ref url="../api-reference/payments/payment-links" %}
[payment-links](https://developers.conomyhq.com/api-reference/payments/payment-links)
{% endcontent-ref %}
{% endtab %}
{% endtabs %}

## Core Docs

{% columns fullWidth="true" %}
{% column %}
{% content-ref url="../api-reference/authentication" %}
[authentication](https://developers.conomyhq.com/api-reference/authentication)
{% endcontent-ref %}
{% endcolumn %}

{% column %}
{% content-ref url="../payments/payment-structure" %}
[payment-structure](https://developers.conomyhq.com/payments/payment-structure)
{% endcontent-ref %}
{% endcolumn %}
{% endcolumns %}

{% columns fullWidth="true" %}
{% column %}
{% content-ref url="../api-reference/payments" %}
[payments](https://developers.conomyhq.com/api-reference/payments)
{% endcontent-ref %}
{% endcolumn %}

{% column %}
{% content-ref url="../payments/origins-and-destinations/nodes" %}
[nodes](https://developers.conomyhq.com/payments/origins-and-destinations/nodes)
{% endcontent-ref %}
{% endcolumn %}
{% endcolumns %}

{% columns fullWidth="true" %}
{% column %}
{% content-ref url="countries" %}
[countries](https://developers.conomyhq.com/home/countries)
{% endcontent-ref %}
{% endcolumn %}

{% column %}
{% content-ref url="currencies" %}
[currencies](https://developers.conomyhq.com/home/currencies)
{% endcontent-ref %}
{% endcolumn %}
{% endcolumns %}

{% columns fullWidth="true" %}
{% column %}
{% content-ref url="../payments/transaction-builder" %}
[transaction-builder](https://developers.conomyhq.com/payments/transaction-builder)
{% endcontent-ref %}
{% endcolumn %}

{% column %}
{% content-ref url="<https://github.com/conomyhq/gitbook-docs/blob/main/payments/available-products.md>" %}
<https://github.com/conomyhq/gitbook-docs/blob/main/payments/available-products.md>
{% endcontent-ref %}
{% endcolumn %}
{% endcolumns %}

## Support and Go-live

Questions about integration, rails, or go-live:

* <hola@conomyhq.com>