Começando
Bem-vindo à Yuupe Pay
Uma API para cobrar no Pix e no cartão, com o split da loja aplicado na própria cobrança, webhooks assinados e mensagens prontas para o comprador.
Quer ir direto ao código?
O Início rápido leva do zero ao primeiro Pix pago no sandbox. A Referência da API traz cada endpoint com exemplos em cURL, Node.js e PHP.
O que a Yuupe Pay oferece
PixQR Code e copia e cola na resposta do pedido, confirmação em segundos.Cartão e 3DSÀ vista ou parcelado, com a confirmação do banco do comprador (3DS 2.0).pay.jsO número do cartão vai do navegador direto para a operadora. Nunca passa pelo seu servidor.WebhooksAvisos assinados (HMAC) a cada mudança de status, com reenvio por 24 h.EstornosTotal ou parcial, com chave de idempotência.Mensagens para o compradorCada recusa vem com a frase pronta para o checkout e se vale tentar de novo.
Como funciona uma venda
- O checkout do seu site coleta o carrinho e os dados do comprador.
- O seu servidor chama
POST /pedidoscom a chave da loja. No cartão, antes, o navegador gera umtoken_cartaocom o pay.js. - A Yuupe Pay cobra na operadora e já divide o valor: a parte da loja e a comissão saem na própria cobrança.
- O comprador paga o Pix ou confirma o cartão com o banco.
- O seu servidor recebe o webhook
pedido.aprovadoe libera a compra.
O status de um pedido só avança depois de confirmado na operadora, e só para frente: um pedido aprovado nunca volta a “aguardando”.
Por onde começar
Início rápidoChave, webhook e o primeiro Pix em minutos.Ambientes e chavesSandbox, produção e o que muda entre eles.Testes e produçãoO checklist antes de virar a chave.Referência da APIEndpoints, campos, respostas e exemplos.
Dúvidas ou um erro que não está aqui: fale com a Yuupe informando o id do pedido (ou o seu numero_pedido) e o horário. Cada pedido tem o histórico completo registrado do nosso lado.