Nesta matéria
Onde: Configurações → Leitores e dinheiro → Conexões → Pagamentos
Abra esta página: admin.<your-site>/settings/connections/payments (substitua <your-site> pelo endereço do seu site)
Antes de começar
- Uma conta no Razorpay. Comece no Modo de teste no Razorpay.
- Você precisa ser a pessoa proprietária do site.
Passo a passo
- No painel do Razorpay, mude para Modo de teste.
- Acesse Configurações → Avançado → Conectar outros apps → Chaves de API e gere uma chave. Copie o key id e o key secret. O Razorpay só mostra o secret uma vez.
- No Keynate, abra Configurações → Leitores e receita → Conexões → Pagamentos e toque em Conectar Razorpay (ou Adicionar conexão).
- Escolha Modo de teste. Cole o ID da chave (ele começa com
rzp_test_), o Chave secreta e o Segredo do webhook. - Toque em Conectar Razorpay no final da tela.
- No cartão, encontre Deixe o Razorpay avisar seu site sobre pagamentos. O Razorpay não permite que outros apps façam isso por você, então leva um minuto no Razorpay. São 3 etapas:
- Abra o Razorpay → Webhooks e toque em Add New Webhook.
- Preencha o formulário do Razorpay com o URL do webhook, o Segredo e os Active events (marque cada um). Cada um tem um botão Copiar. O secret só aparece uma vez. Se o perdeu, toque em Editar e depois em Gerar um novo código secreto para mim.
- Toque em Create Webhook. Depois, faça um pagamento de teste pequeno.
- Observe a linha abaixo das etapas. Ela mostra Waiting for Razorpay's first message… e fica verde com We received Razorpay's first message. quando dá certo. Os pagamentos passam a constar como pagos automaticamente. Toque em Verificar agora para verificar novamente. Mais tarde, Ver o passo a passo de novo abre as etapas.
- Toque em Testar conexão no cartão e faça um pagamento de teste.
- Quando funcionar, toque em Go live with Razorpay na barra do modo de teste e insira suas chaves de produção (
rzp_live_). No modo de produção, o cartão fica verde após seu primeiro pagamento real.
Mais ajuda: Mensagens de pagamento (webhook).
Importante saber
- Os key ids precisam começar com
rzp_test_para o modo de teste ourzp_live_para o modo de produção. - Use um webhook secret diferente para teste e produção.
Problemas comuns
- "Key ids start with rzp_test_ (test mode) or rzp_live_ (live mode). Copy it from the API keys page inside your Razorpay dashboard."
- "Paste the key secret. Razorpay shows it only once, when you create the key." Gere uma nova chave se tiver perdido.
- "Paste the webhook secret you typed in Razorpay."
Dúvidas frequentes
Perguntas frequentes
Onde fica a página de chaves do Razorpay?
A janela tem um link que a abre em uma nova aba, e o painel lateral da página traz Abrir API keys no Razorpay e Abrir webhooks no Razorpay.
Como saber se o webhook está funcionando?
O cartão exibe We received Razorpay's first message.; até lá, mostra Waiting for Razorpay's first message…. Se o Stripe ou o PayPal também estiverem ativos, o cartão não consegue distinguir qual enviou a mensagem e avisa sobre isso. Se você já fez isso uma vez, não há mais nada a fazer.
Onde fica a opção do modo de teste?
No painel do Razorpay. Mude para Modo de teste antes de gerar as chaves.