Autenticacao
Autenticacao
A API utiliza autenticacao via X-Client-Id e X-API-Key. Voce deve incluir essas credenciais em todas as requisicoes.
Headers Obrigatorios
Headers
http
X-Client-Id: e1c98954cc404cbcb2868af9b40c7a33X-API-Key: sua-api-key-secretaContent-Type: application/jsonAccept: application/jsonParametros dos Headers
| Parametro | Tipo | Descricao |
|---|---|---|
X-Client-Idobrigatorio | string | Identificador unico da sua aplicacao (publico) |
X-API-Keyobrigatorio | string | Chave secreta de autenticacao da API |
Content-Typeobrigatorio | string | Sempre deve ser application/json |
Acceptobrigatorio | string | Sempre deve ser application/json |
Como Obter Credenciais
Para usar a API Rayo, voce precisa de um par de credenciais: Client ID e API Key.
Passo a Passo
- 1Acesse o painel em https://rayopay.com.br/login-company
- 2Navegue ate Configuracoes → API & Integracoes
- 3Copie o Client ID (publico e unico para sua aplicacao)
- 4Clique em Gerar Nova Chave para criar uma API Key
- 5Guarde sua API Key em um local seguro (ela sera exibida apenas uma vez)
Exemplo de Requisicao
cURL
bash
curl -X POST https://rayopay.com.br/api/v1/transactions \ -H "X-Client-Id: e1c98954cc404cbcb2868af9b40c7a33" \ -H "X-API-Key: sua-api-key-secreta" \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -d '{ "amount": 100.00, "description": "Pagamento teste" }'Importante
A API Key e secreta e deve ser armazenada com seguranca. Nunca a compartilhe ou exponha em codigo cliente (frontend). Utilize sempre variaveis de ambiente no servidor.