Get started

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

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.

Create a debt

Provide the amount and the debtor. TapiPay handles the rest internally.

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" }
  }'

Share the charge

The response includes a payment URL ready to share with your customer through whichever channel you prefer.

Explore every available endpoint and try them out live in the API Reference.

Introduction Authentication

Concepts

Resources

Payment portal

Webhooks

Get started