Referência

Envie dinheiro via PIX para qualquer chave PIX

Com o PIX você envia dinheiro para qualquer chave PIX que não seja da conta titular — terceiros, fornecedores ou parceiros.

PIX vs Saques: use PIX para enviar a chaves de terceiros; use Saques para enviar para sua própria chave.

Estrutura

Exemplo de resposta de uma transação PIX:

{
  "data": {
    "id": "txn_abc123xyz",
    "status": "PENDING",
    "devMode": false,
    "receiptUrl": "https://app.abacatepay.com/receipt/txn_abc123xyz",
    "amount": 10000,
    "platformFee": 100,
    "externalId": "pix-123",
    "createdAt": "2024-11-04T18:38:28.573Z",
    "updatedAt": "2024-11-04T18:38:28.573Z"
  },
  "success": true,
  "error": null
}

Atributos

Atributo	Tipo	Descrição
id	string	ID único da transação na AbacatePay
status	string	Status da transação (veja valores abaixo)
devMode	boolean	true se criado em sandbox
receiptUrl	string	URL do comprovante; disponível quando status é COMPLETE
amount	number	Valor em centavos (ex.: 10000 = R$ 100,00)
platformFee	number	Taxa da plataforma em centavos
externalId	string | null	ID no seu sistema; pode ser null
createdAt	string	Data/hora de criação (ISO 8601)
updatedAt	string	Data/hora da última atualização

Valores de status:

Valor	Significado
PENDING	Criado, aguardando processamento
EXPIRED	Expirado
CANCELLED	Cancelado
COMPLETE	Concluído com sucesso
REFUNDED	Reembolsado

Tipos de chave PIX

Ao criar um PIX, informe o tipo da chave de destino:

Tipo	Descrição	Exemplo
CPF	CPF (11 dígitos)	12345678901
CNPJ	CNPJ (14 dígitos)	12345678000190
PHONE	Celular (DDD + número)	11987654321
EMAIL	E-mail	[e-mail]
RANDOM	Chave aleatória (UUID)	a1b2c3d4-e5f6-...
BR_CODE	Código BR (QR Code)	Código completo do QR

Limites e taxas

• Mínimo: R$ 1,00
• Taxa: ver termos de uso
• Processamento: instantâneo; disponível 24/7
• Limite: consulte o dashboard; excesso pode retornar HTTP 429

Segurança

• Requisições autenticadas via Bearer Token
• Abusos podem levar à suspensão da conta conforme os termos de uso