Referência

​

Como funciona

1. Você chama POST /customer-portal/create com o customerId e o checkoutId.
2. A API devolve a url, no formato https://portal.abacatepay.com/<token>.
3. O cliente abre o link e digita o e-mail da compra. Se bater com o do cadastro, ele recebe um código de 6 dígitos, válido por 10 minutos.
4. Com o código, ele entra no portal. A sessão dura 1 hora; depois disso, pede outro código.

POST /customer-portal/create
{
  "customerId": "cust_abc123xyz",
  "checkoutId": "bill_abc123xyz"
}

{
  "data": {
    "id": "cpl_abc123xyz",
    "url": "https://portal.abacatepay.com/k3J9xQ2mP7vL1nR8sT4wY6zA0bC5dE2f",
    "customerId": "cust_abc123xyz",
    "checkoutId": "bill_abc123xyz",
    "devMode": false,
    "createdAt": "2026-10-19T12:00:00.000Z"
  },
  "success": true,
  "error": null
}

​

Um link por cliente e checkout

• O link só mostra o que aquele cliente pagou naquele checkout. Ele não vê outras compras nem outras lojas.
• Chamar de novo com o mesmo customerId e checkoutId devolve o mesmo link.
• O link não expira. Quem tem o link ainda precisa do código enviado ao e-mail do cliente para entrar.

​

O que o cliente pode fazer