Autenticação

Como obter seus Tokens de API

1. Faça login em sua conta RecebeAqui
2. Acesse a área de API no seu perfil
3. Gere ou copie seus tokens de API
4. Utilize tokens diferentes para produção e sandbox

Cabeçalho de Autenticação

Inclua o token no cabeçalho Authorization de todas as requisições:

Authorization: Bearer {seu_token_de_api}

Exemplo de Requisição

Aqui está um exemplo de como fazer uma requisição autenticada:

• cURL
• JavaScript
• C#

curl -X GET "https://api.recebeaqui.com/v2/api/checkout?id=123e4567-e89b-12d3-a456-426614174000" \
  -H "Authorization: Bearer {seu_token_de_api}" \
  -H "Content-Type: application/json"

const response = await fetch('https://api.recebeaqui.com/v2/api/checkout?id=123e4567-e89b-12d3-a456-426614174000', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer {seu_token_de_api}',
    'Content-Type': 'application/json'
  }
});

const data = await response.json();

using System.Net.Http.Headers;

var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "{seu_token_de_api}");

var response = await client.GetAsync("https://api.recebeaqui.com/v2/api/checkout?id=123e4567-e89b-12d3-a456-426614174000");
var content = await response.Content.ReadAsStringAsync();

Ambientes

Testando Pagamentos no Sandbox

Para realizar testes de pagamentos no ambiente sandbox, utilize os seguintes cartões de teste:

Erros de Autenticação

Se o token estiver ausente, expirado ou inválido, você receberá um erro 401:

{
  "title": "Unauthorized",
  "status": 401,
  "detail": "Token de autenticação inválido, expirado ou ausente."
  "errors": {}
}