Pagador sem conta
Receba Pix de quem não tem conta XPayZ, sem nenhuma mudança na sua integração.
Quem paga um link não precisa ter conta XPayZ nem preencher nada: basta pagar o Pix. Quem enviou o Pix vira o pagador, e a conta dele é criada automaticamente com os dados que o banco informa.
Para você, nada muda: o link é o mesmo, os webhooks são os mesmos e o dinheiro cai na sua conta como em qualquer pagamento.
Como funciona
- 1Gera o PixNo checkout, sem login e sem formulário.
- 2Paga de qualquer bancoO nome e o CPF ou CNPJ de quem pagou vêm do próprio Pix.
- 3Pagamento concluídoA XPayZ cadastra o pagador, conclui o pagamento e você recebe event.completed.
Regras
| Meio de pagamento | Só Pix. Cartão e saldo XPayZ continuam exigindo conta. |
| Identificação | O pagador é quem enviou o Pix: nome e CPF ou CNPJ vêm do banco, não do checkout. Eles aparecem no pagamento depois que o Pix chega. |
| Moeda | Só links em BRL, por enquanto. Num link em USD, o pagador precisa ter conta. |
| Cadastro | O pagador é cadastrado com o documento do Pix. Se ele criar uma conta XPayZ depois, com o mesmo documento, o cadastro já existe. |
Pela API
Se você usa o checkout da XPayZ (link ou iframe), não precisa fazer nada. Para
montar a sua própria tela de pagamento, veja Checkout transparente:
é só chamar POST /pay sem payer_id.
Como identificar nos pagamentos
Em Listar pagamentos do link, quem pagou sem conta vem com
payer_type: "end_consumer". Quem tem conta vem com customer. payer_name e payer_document ficam
vazios até o Pix chegar; payer_email só vem se o pagador informou um email.
{
"id": "0d4ba8f5-bbc6-4cbb-ae65-13de2f903271",
"status": "done",
"method": "pix",
"payer_name": "Maria Silva",
"payer_email": "maria@example.com",
"payer_document": "12345678909",
"payer_type": "end_consumer",
"currency": "BRL",
"amount": "100"
}Libere o pedido pelo webhook
Como em qualquer pagamento, confirme pelo event.completed. Entre o Pix cair e o pagamento ser
concluído há alguns segundos a mais, o tempo de cadastrar o pagador.
Testando
No sandbox, gere o Pix sem estar logado. Como não há documento para escolher um cenário, o pagamento
é sempre concluído e você recebe event.created e depois event.completed. Para testar recusa,
cancelamento e expiração, pague com conta usando os CPFs de Simular pagamentos.