O Checkout da InfinitePay permite integrar seu site ou sistema de vendas com a nossa API e gerar links de pagamento automaticamente.

Quando seu cliente finaliza um pedido, você cria o link via API e direciona ele direto para a tela de pagamento.

📝 Antes de começar

Alguns termos importantes:

Vendedor: você, o dono do site de vendas.
Comprador: a pessoa que vai fazer a compra.
Handle: sua InfiniteTag (a identificação que aparece no canto superior esquerdo do App InfinitePay). Use sem o símbolo $ do início.
order_nsu: o número do pedido no seu sistema.

📱 Como acessar

Acesse sua conta.
Clique em Checkout no menu.
Consulte a documentação para configurar as credenciais.
Clique em Criar checkout.

Pronto! Agora é só personalizar para o seu negócio.

✨ Vantagens e quando usar

Automatize a geração de links de pagamento no seu site
Receba notificações automáticas de pagamentos via webhook
Direcione o cliente direto para a tela de pagamento, sem etapas extras
Ideal para e-commerces, plataformas de cursos, marketplaces e sistemas próprios de vendas

Se você vende por um site ou sistema e quer integrar os pagamentos diretamente, o Checkout é a solução ideal.

🔧 Como funciona a integração?

O processo é bem direto: quando alguém faz um pedido no seu site, você envia os dados para a InfinitePay, recebe um link de pagamento e direciona seu cliente para finalizar a compra. Simples assim!

1️⃣ Criando o link de pagamento

Enviando o pedido pra InfinitePay

Assim que seu cliente fizer um pedido, você vai enviar uma requisição POST pra gente:

POST https://api.infinitepay.io/invoices/public/checkout/links

Aqui está um exemplo simples de como montar sua requisição:
json
{
  "handle": "sua_infinite_tag",
  "redirect_url": "https://seusite.com/obrigado",
  "webhook_url": "https://seusite.com/webhook", 
  "order_nsu": "123456",
  "items": [
    {
      "quantity": 1,
      "price": 1000,
      "description": "Curso de Vendas Online"
    },
    {
      "quantity": 1,
      "price": 500,
      "description": "Taxa de entrega"
    }
  ]
}

Dica: O preço sempre vai em centavos. Então R$ 10,00 = 1000 centavos!

Quer incluir os dados do cliente?

Se você já tem as informações do comprador, pode enviar junto para facilitar o processo:

json
{
  "handle": "sua_infinite_tag",
  "redirect_url": "https://seusite.com/obrigado",
  "order_nsu": "123456",
  "customer": {
    "name": "João Silva",
    "email": "joao@email.com",
    "phone_number": "+5511999887766"
  },
  "items": [...]
}

E o endereço também?

Se o seu produto precisa ser entregue em mãos, você pode incluir o endereço:

json
{
  "handle": "sua_infinite_tag",
  "redirect_url": "https://seusite.com/obrigado",
  "order_nsu": "123456",
  "address": {
    "cep": "12345678",
    "number": "123",
    "complement": "Apto 45"
  },
  "items": [...]
}

Recebendo o link de pagamento

Se tudo der certo, você vai receber uma resposta assim:

json
{
  "url": "https://checkout.infinitepay.com.br/sua_tag?lenc=codigo_unico"
}

Agora é só direcionar seu cliente para essa URL! 🎯

2️⃣ Depois que o pagamento acontecer

Redirecionamento automático

Quando seu cliente finalizar o pagamento, ele deve clicar em "Continuar" para ser redirecionado ao seu site (na redirect_url que você configurou). A URL vai vir com alguns parâmetros importantes:

receipt_url - Link do comprovante de pagamento: você pode disponibilizar esse link para o comprador
order_nsu - O número do pedido no seu sistema (que você enviou)
slug - Código da fatura na InfinitePay
capture_method - Como foi pago ("credit_card" ou "pix")
transaction_nsu - ID único da transação

3️⃣ Confirmando se o pagamento foi aprovado

Agora você tem duas opções para verificar se o pagamento realmente aconteceu:

Opção 1: Verificação manual (sem webhook)

Você pode consultar o status do pagamento fazendo uma requisição:

POST https://api.infinitepay.io/invoices/public/checkout/payment_check

Corpo da requisição:
json
{
  "handle": "sua_infinite_tag",
  "order_nsu": "123456",
  "transaction_nsu": "UUID-que-recebeu",
  "slug": "codigo-da-fatura"
}
Resposta:
json
{
  "success": true,
  "paid": true,
  "amount": 1500,
  "paid_amount": 1510,
  "installments": 1,
  "capture_method": "pix"
}

Opção 2: Webhook

Se você configurou o webhook_url, a gente envia os dados da venda automaticamente pro seu sistema:


json
{
  "invoice_slug": "abc123",
  "amount": 1000,
  "paid_amount": 1010,
  "installments": 1,
  "capture_method": "credit_card",
  "transaction_nsu": "UUID",
  "order_nsu": "UUID-do-pedido",
  "receipt_url": "https://comprovante.com/123",
  "items": [...]
}

🎯 Como responder ao webhook?

Importante: Responda rapidamente (de preferência em menos de 1 segundo) com um desses códigos:

✅ Se deu tudo certo:

Status: 200 OK
{
  "success": true,
  "message": null
}

❗ Se algo deu errado:

Status: 400 Bad Request
{
  "success": false,
  "message": "Pedido não encontrado"
}

Dica: Se você responder com erro 400, a gente tenta enviar novamente!

💡 Dicas práticas

Webhook é mais eficiente que ficar consultando manualmente
Sempre valide se o order_nsu corresponde a um pedido real no seu sistema
Guarde o transaction_nsu pra futuras consultas
Teste bastante no ambiente de desenvolvimento antes de colocar no ar

Se ficou com alguma dúvida ou encontrou algum problema, nossa equipe está aqui pra te ajudar!

🔔 Precisa de ajuda?

Fale com nossa equipe pelo chat no App InfinitePay.

🔒 Cuide da sua segurança!

A InfinitePay entra em contato apenas através de canais oficiais e números verificados. Nunca clique em links suspeitos ou compartilhe senhas e códigos de segurança. Saiba mais acessando nosso Guia de Segurança.

Como usar o Checkout da InfinitePay?