Quais formas de pagamento posso aceitar?
Quais formas de pagamento posso aceitar?
Pix, cartão de crédito (em 1, 2, 3, 6 ou 12 vezes) e boleto com Pix embutido. Pix pode ser cobrado direto pela API. Cartão e boleto são pagos pelo checkout da Valora.
Preciso saber programar?
Preciso saber programar?
Não. Você cria um link de pagamento no painel e compartilha. A API é para quem quer integrar a venda no próprio sistema.
Quanto custa?
Quanto custa?
Não há mensalidade nem taxa de adesão. Você paga uma taxa por transação. As taxas estão no site da Valora, e a taxa de cada pagamento aparece no campo
fee.Quando o dinheiro fica disponível?
Quando o dinheiro fica disponível?
Pix e boleto ficam disponíveis assim que o pagamento é confirmado. Vendas no cartão são liberadas em parcelas mensais, a partir de 30 dias após a compra. Veja Saldo e saques.
Como saco o meu saldo?
Como saco o meu saldo?
Pelo painel, em Saques, para a chave Pix da empresa. Não existe saque pela API.
Por que os valores vêm em centavos?
Por que os valores vêm em centavos?
Para evitar erros de arredondamento. Você envia
"49.90" (reais) e recebe 4990 (centavos inteiros). Divida por 100 para exibir.Posso criar cobranças de cartão pela API?
Posso criar cobranças de cartão pela API?
Não diretamente. Crie uma compra com
POST /v1/checkouts e mande o cliente para o checkout_url. Assim o número do cartão nunca passa pelo seu servidor.Como devolvo um pagamento?
Como devolvo um pagamento?
Pix: com
POST /v1/payments/{payment_id}/refund, total ou parcial. Cartão e boleto: fale com o suporte.O cliente voltou para a success_url. Posso liberar o pedido?
O cliente voltou para a success_url. Posso liberar o pedido?
Não. Libere só ao receber o webhook
payment.succeeded com assinatura válida.Meu webhook não está chegando. O que confiro?
Meu webhook não está chegando. O que confiro?
- A URL é HTTPS e pública (não
localhostnem IP interno)? - O endpoint está inscrito no evento?
- O seu servidor responde
2xxem menos de 10 segundos? - Veja o status HTTP e o erro de cada entrega em Desenvolvedores → Webhooks e reenvie se precisar.
Recebi 401 invalid_api_key.
Recebi 401 invalid_api_key.
Confira o header
Authorization: Bearer sk_vl_..., sem espaços ou aspas a mais, e se a chave não foi revogada.Recebi 429 rate_limited.
Recebi 429 rate_limited.
Você passou de 300 requisições por minuto com a mesma chave. Espere os segundos indicados no header
Retry-After e tente de novo.