Documentacao Oficial

Rayo Payment API

Bem-vindo a documentacao oficial da API Rayo. Aqui voce encontrara tudo o que precisa para integrar pagamentos PIX em sua aplicacao.

Visao Geral

A Rayo Payment API e uma solucao server-to-server para processamento de pagamentos que suporta:

PIX - Pagamentos Instantaneos

Receba pagamentos em tempo real via PIX com QR Code dinamico, chave PIX e notificacoes instantaneas via webhook.

URL Base

Base URL

url

https://rayopay.com.br

Todas as requisicoes devem usar esta URL como base.

Formato de Resposta

Todas as respostas da API sao retornadas no formato JSON. Em caso de erro, seguimos o padrao RFC 7807 (Problem Details).

Exemplo de Resposta de Sucesso

response.json

json

{
  "data": {
    "id": "f2d96218-6635-4839-81d7-9f2d5aaf4f14",
    "status": "WAITING_PAYMENT",
    "paymentMethod": "PIX",
    "amount": 500
  },
  "status": 200,
  "message": "Transação criada com sucesso."
}

Comece por aqui

Autenticacao

Configure suas credenciais de API

Criar Cobranca PIX

Gere um QR Code para pagamento

Webhooks

Receba notificacoes em tempo real

Tratamento de Erros

Entenda os codigos de erro

Importante

Para comecar a usar a API Rayo, voce precisa primeiro obter suas credenciais de acesso. Consulte a secao de Autenticacao para mais detalhes.