Reborn Guides

Entenda os principais fluxos antes de abrir a referência completa.

Veja como configurar ambientes, autenticar requisições, criar experiências de checkout, utilizar Reborn Elements e receber eventos da operação. Esta é uma visão resumida — parâmetros, schemas e exemplos completos estão na documentação oficial.

Acessar documentação completaAbrir API Reference

Integration Guide

Seu caminho inicial

01
Escolha o ambiente

1

02
Gere a API Key

2

03
Autentique as requisições

3

04
Crie checkout session ou transação

4

05
Configure webhooks

5

06
Valide no sandbox

6

07
Prepare a produção

7

Configure o ambiente e faça sua primeira integração.

Gere a chave no dashboard, autentique, crie links ou checkout sessions, configure webhooks e valide no sandbox antes da produção. A documentação do seller não expõe rotas administrativas internas.

https://sandbox-api.rebornpay.io
https://api.rebornpay.io

Autentique chamadas de servidor com a chave da operação.

A API usa uma chave associada ao seller. Header principal X-Api-Key; alternativa Authorization: ApiKey. Chaves no servidor, nunca no frontend; separar ambientes; não logar a chave.

curl -X GET \
  'https://sandbox-api.rebornpay.io/v1/sellers/{id}/dashboard/overview' \
  -H 'X-Api-Key: $API_KEY'

Trate falhas usando uma estrutura previsível.

As respostas usam o objeto ErrorResponse. Utilize o campo code para tratamento programático; validações podem retornar mais de um item em errors.

{
  "errors": [
    {
      "status": "400",
      "code": "REQ_001",
      "title": "Requisição inválida",
      "description": "..."
    }
  ],
  "metadata": {
    "totalRecords": 1,
    "requestDatetime": "2026-06-05T12:00:00Z"
  }
}

Pix e cartão com fluxos adequados ao navegador.

O checkout usa sessões para conectar o navegador à infraestrutura. O fluxo muda conforme o método.

  • Fluxo Pix
  • Fluxo cartão · 3DS2

Componentes para construir experiências de pagamento no navegador.

O SDK browser da Reborn para Pix, cartão, parcelamento e diferentes superfícies de checkout. Sandbox: pk_test_… · base sandbox-api.rebornpay.io · domínios permitidos configurados no painel do seller.

  • Hosted redirect · checkout hospedado
  • Embedded iframe · incorporado
  • Payment Element · Pix + cartão + 3DS
  • Headless · UI pelo integrador
  • Direct API · transação + 3DS
@rebornpay/elements
elements-react
elements-vue
elements-remix
elements-web

Receba mudanças de estado diretamente no seu servidor.

Configurados por seller, enviam POST com JSON para a URL cadastrada quando um evento selecionado acontece. Valide a assinatura antes de processar.

Deslize para ver a tabela →
EVENTO
TRANSACTION_PAID
DESCRIÇÃO
pagamento confirmado
EVENTO
TRANSACTION_REFUNDED
DESCRIÇÃO
estorno concluído
EVENTO
TRANSACTION_CANCELLED
DESCRIÇÃO
cancelada antes do pgto
Ver mais 4 lançamentos
EVENTO
SELLER_STATUS_CHANGED
DESCRIÇÃO
status de KYC
EVENTO
CHARGEBACK_RECEIVED
DESCRIÇÃO
chargeback / alerta
EVENTO
SETTLEMENT_PAID
DESCRIÇÃO
liquidação paga
EVENTO
PAYMENT_LINK_*
DESCRIÇÃO
ciclo do link
Assinatura HMAC-SHA256 · até 5 tentativas · intervalo 60 s · deduplicação type + data.transaction.idBalanceado
EVENTODESCRIÇÃO
TRANSACTION_PAIDpagamento confirmado
TRANSACTION_REFUNDEDestorno concluído
TRANSACTION_CANCELLEDcancelada antes do pgto
SELLER_STATUS_CHANGEDstatus de KYC
CHARGEBACK_RECEIVEDchargeback / alerta
SETTLEMENT_PAIDliquidação paga
PAYMENT_LINK_*ciclo do link

Envelope de webhook

Valide o body bruto (sem reserializar). Responda 2xx no prazo. Histórico em /webhooks/deliveries.

X-Reborn-Signature: hmac
Content-Type: application/json

{
  "type": "TRANSACTION_PAID",
  "sellerId": "seller_example",
  "occurredAt": "2026-06-18T03:04:08Z",
  "data": { "transaction": { "id": "tx_…", "status": "PAID" } }
}

Fluxos recomendados por objetivo.

Quero processar Pix
Primeiros passos → Autenticação → Checkout → Webhooks
Quero aceitar cartão
Primeiros passos → Autenticação → Checkout → Elements → Webhooks
Quero meu próprio checkout
Elements → Checkout → API Reference → Webhooks → Erros
Quero integrar meu ERP
Autenticação → Webhooks → Erros → API Reference

  • Primeiros passos

    Ambientes, credenciais e fluxo inicial.

  • Autenticação

    Chaves de API e chamadas protegidas.

  • Erros

    Estrutura padronizada para tratamento programático.

  • Checkout

    Pix, cartão, checkout sessions e 3DS2.

  • Reborn Elements

    SDK browser, componentes e superfícies de integração.

  • Webhooks

    Eventos, assinatura, retries e histórico de entregas.

Primeiros passos

Ambientes, credenciais e fluxo inicial.

Autenticação

Chaves de API e chamadas protegidas.

Erros

Estrutura padronizada para tratamento programático.

Checkout

Pix, cartão, checkout sessions e 3DS2.

Reborn Elements

SDK browser, componentes e superfícies de integração.

Webhooks

Eventos, assinatura, retries e histórico de entregas.

Precisa de parâmetros e schemas?

Os guias explicam o fluxo. A API Reference contém endpoints, headers, query parameters, request bodies, responses e exemplos executáveis.

Comece pelo ambiente de testes.
Gere a API Key, valide requests e revise responses antes de operar em produção.

Pronto para abrir a documentação completa?

Consulte os guias oficiais para fluxos detalhados, endpoints, schemas, exemplos de código e instruções de produção.

Acessar documentação completaAbrir API Reference