Criar PIX

Esse endpoint cria um código PIX para pagamento.

Pontos de atenção

• Tenha sua conta CRIADA e Aprovada.
• Caso não tenha conta realizar no link https://app.pushinpay.com.br/register
• Para utilização do ambiente SANDBOX fazer o cadastro primeiramente no ambiente de produção (acima) e depois no suporte solicitar a liberação do ambiente SANDBOX;
• Valores sempre em CENTAVOS.
• Valor mínimo de 50 centavos;
• Percentual máximo de 50% para SPLIT entre contas;
• Checar o limite de valor máximo em sua conta;
• Caso não tenha um servidor para receber as notificações da transação não preencha o campo webhook_url;

Obrigatoriedade de Aviso sobre o Papel da PUSHIN PAY

• Item 4.10 do nosso Termos de Uso https://pushinpay.com.br/termos-de-uso;
• É de responsabilidade do usuário da plataforma PUSHIN PAY, titular da conta, informar de maneira clara, destacada e acessível em seus canais de venda (sites, redes sociais, aplicativos, plataformas, entre outros), que:
• “A PUSHIN PAY atua exclusivamente como processadora de pagamentos e não possui qualquer responsabilidade pela entrega, suporte, conteúdo, qualidade ou cumprimento das obrigações relacionadas aos produtos ou serviços oferecidos pelo vendedor.”
• Esse aviso deve constar no momento da oferta e antes da finalização do pagamento, preferencialmente na página de checkout, nos termos de compra e/ou nas comunicações automáticas relacionadas à transação.
• O não cumprimento pode gerar penalizações e até bloqueio da conta;

Exemplo de Resposta - Endpoint

 
{
  "id": "9c29870c-9f69-4bb6-90d3-2dce9453bb45",
  "qr_code": "00020101021226770014BR.GOV.BCB.PIX2555api...",
  "status": "created",
  "value": 35,
  "webhook_url": "http://teste.com",
  "qr_code_base64": "data:image/png;base64,iVBORw0KGgoAA.....",
  "webhook": null,
  "split_rules": [],
  "end_to_end_id": null,
  "payer_name": null,
  "payer_national_registration": null
}

📝 Descrição dos Campos

Webhook de retorno

Ao adicionar o campo webhook_url na criação do qrcode pix, quando o status for alterados e caso falhe a tentativa nós tentaremos enviar 3x, e caso as 3x falhe, via painel administrativo será possível retomar os envios do mesmo. Também é possível adicionar um header customizado que iremos enviar para você em todos os webhooks, essa configuração está disponível em seu menu de configurações de nosso painel

Não recomendamos a pratica de scrap, por isso atente-se a usar os nossos webhooks para receber alterações de status

Erros de Limite e Validação

• Valor acima do limite permitido: Quando o valor enviado para geração do QR Code PIX ultrapassa o limite máximo configurado na conta , será retornada a mensagem informando o valor máximo permitido ;
• Valor do split maior que o valor total: Se o valor definido para o split for maior do que o valor total da transação, será retornado um erro indicando que o valor da transação não pode ser menor que o valor do split.
• Split + taxa maior que o valor total: Quando a soma do valor do split com a taxa de transação for maior que o valor total da transação, o sistema retorna uma mensagem indicando que isso não é permitido.
• Conta de split não encontrada: Caso o account_id informado em algum dos splits não corresponda a uma conta válida no banco de dados, será exibida uma mensagem de erro informando que a conta não foi encontrada.
• Valor total dos splits excede o valor da transação: Se a soma dos valores dos splits (incluindo a taxa) for maior que o valor total da transação, um erro será retornado informando que a soma não pode exceder o valor da transação.
• Splits do token inválidos: A mesma validação anterior se aplica ao caso em que os splits vêm de um token usado na geração da transação. Se os valores forem inconsistentes, o erro indicará que a soma dos splits vinculados ao token não pode exceder o valor da transação.