Introdução
Nossa API permite controle completo das funcionalidades do Pix, como geração de chave, recebimento através de QR Code dinâmico e estático, além de envio de dinheiro (pagamentos) através de chave pix, dados dados bancários e QR Codes.
Esta sessão de nossa documentação foca em orientá-lo no recebimento através de Pix. Para entende como fazer o envio de dinheiro (pagamentos), verifique a sessão de transferências.
Existem três maneiras de receber via Pix:
- Gerar uma cobrança com a forma de recebimento "PIX" que realiza as notificações de cobrança automaticamente para o seu cliente e que também permite recuperar o QrCode Dinâmico após a sua criação;
- Cadastrando uma chave e informando-a ao seu cliente;
- Criando um QrCode estático.
Ao receber um pagamento através da chave Pix ou um QrCode estático, um cliente e uma cobrança serão criados automaticamente para registro desse pagamento em sua conta.
Recebendo cobranças e transferências via Pix
O primeiro passo para receber cobranças ou transferências via Pix é criar uma chave Pix em sua conta.
Esta é uma funcionalidade que só estará habilitada após a sua conta estar 100% aprovada e a prova de vida ter sido realizada.
ATENÇÃO: Sem uma chave PIX cadastrada em sua conta, pode haver lentidão no processamento dos pagamentos via PIX.
Se sua conta não tiver uma chave PIX cadastrada, nossa aplicação precisará gerar uma chave temporária para processar o recebimento. Esse processo pode causar demora na conclusão da cobrança, impactando a experiência do seu cliente.
Por isso, recomendamos cadastrar uma chave PIX na sua conta para garantir que os pagamentos sejam processados de forma instantânea.
Criando uma chave Pix
No momento, através da API é possível criar somente chaves aleatórias (EVP). Lembramos que há uma restrição no número de chaves que cada conta pode criar: 5 para pessoa física e 20 para pessoa jurídica.
POST
/v3/pix/addressKeys
Confira a referência completa deste endpoint
{
"type": "EVP",
}
Por limitações aplicadas pelo Banco Central, deve-se aguardar 1 minuto entre cada chave criada para uma conta.
O Banco Central também aplica os limites de chaves por conta informados acima.
Updated 3 days ago