Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.abacatepay.com/llms.txt

Use this file to discover all available pages before exploring further.

AbacatePay Python SDK

Repositório oficial — issues, changelog e contribuições.

Pré-requisitos

Instalação

pip install abacatepay

Configuração

Armazene sua chave de API em uma variável de ambiente e nunca no código:
# .env
ABACATEPAY_API_KEY=sua_chave_aqui
import os
import abacatepay

client = abacatepay.AbacatePay(os.environ["ABACATEPAY_API_KEY"])

Primeira cobrança

from abacatepay.products import Product

checkout = client.billing.create(
    products=[
        Product(
            external_id="PRO-PLAN",
            name="Pro plan",
            quantity=1,
            price=1000,  # em centavos
        )
    ],
    return_url="https://meusite.com/app",
    completion_url="https://meusite.com/pagamento/sucesso",
)

print(checkout.data.url)  # URL de pagamento para o cliente
Resposta:
{
  "success": true,
  "error": null,
  "data": {
    "id": "bill_12345667",
    "url": "https://app.abacatepay.com/pay/bill_12345667",
    "amount": 1000,
    "status": "PENDING",
    "devMode": true,
    "createdAt": "2024-11-04T18:38:28.573Z"
  }
}

Próximos passos

Configurar webhooks

Receba notificações em tempo real sobre pagamentos confirmados.

Checkout Transparente

Aceite PIX e cartão diretamente na sua interface.

Criar clientes

Gerencie clientes vinculados às cobranças.

Referência completa

Todos os endpoints, status codes e formato de resposta.