> ## Documentation Index
> Fetch the complete documentation index at: https://devs.tapipay.la/llms.txt
> Use this file to discover all available pages before exploring further.

# Get started

> Authenticate and create your first charge with the TapiPay Facade API.

In this guide you will authenticate and create your first debt in a matter of minutes.

<Steps>
  <Step title="Have your TAPI token ready">
    The Facade uses two credentials: your **API key** (`x-api-key` header) and your **TAPI token** (`x-authorization-token` header, without the `Bearer` prefix). The TAPI token is the same one you already use with the rest of the Tapi platform. More details in [Authentication](/en/authentication).
  </Step>

  <Step title="Create a debt">
    Provide the amount and the debtor. TapiPay handles the rest internally.

    ```bash theme={null}
    curl -X POST https://tapipay-facade.dev.tapila.cloud/debts \
      -H "x-api-key: YOUR_API_KEY" \
      -H "x-authorization-token: YOUR_TAPI_TOKEN" \
      -H "Content-Type: application/json" \
      -d '{
        "amount": 1500.00,
        "currency": "MXN",
        "dueDate": "2026-08-31",
        "contactData": { "externalClientId": "CLI-00042", "name": "Juan Pérez", "email": "juan@example.com" }
      }'
    ```
  </Step>

  <Step title="Share the charge">
    The response includes a payment URL ready to share with your customer through whichever channel you prefer.
  </Step>
</Steps>

<Tip>
  Explore every available endpoint and try them out live in the [API Reference](/api-reference).
</Tip>