Pular para conteúdo

Criando o cliente

Você pode instanciar o cliente do SDK da AbacatePay de forma simples usando a função AbacatePay. Por padrão, o cliente é síncrono para manter compatibilidade com versões anteriores.

1. Criando o cliente (modo padrão síncrono)

from abacatepay import AbacatePay

client = AbacatePay("<sua chave de API>")

Com o client criado, você terá acesso aos serviços:

client.billing      # Cobranças
client.customers    # Clientes
client.coupons      # Cupons
client.pixQrCode    # Pagamentos Pix (QR Code)

Boa prática

  • Mantenha sua chave de API fora do código-fonte. Prefira variáveis de ambiente.
import os
from abacatepay import AbacatePay

api_key = os.getenv("ABACATEPAY_API_KEY")
client = AbacatePay(api_key)

Se ainda não tem uma chave, veja o tutorial Como pegar minha chave de acesso.

2. Sobre o modo assíncrono (visão geral)

Se preferir trabalhar de forma assíncrona, você pode habilitar o modo async passando async_mode=True ao criar o cliente. Para detalhes, veja: Uso assíncrono.

from abacatepay import AbacatePay

client = AbacatePay("<sua chave de API>", async_mode=True)  # retorna AbacatePayAsyncClient

Também é possível importar as classes diretamente para uma declaração explícita:

from abacatepay import AbacatePayClient

client = AbacatePayClient("<sua chave de API>")

from abacatepay import AbacatePayAsyncClient

client = AbacatePayAsyncClient("<sua chave de API>")

Para um guia completo sobre padrões de uso com asyncio, veja: Uso assíncrono.

3. Próximos passos