Criar webhook

posthttps://sandbox-api.rebornpay.io/v1/sellers/{sellerId}/webhooksAuth obrigatória

Cria um novo webhook para o seller. O `secret` retornado deve ser armazenado de forma segura — ele é usado para validar a autenticidade das requisições via HMAC-SHA256 e **não será exibido novamente**. **Headers enviados em cada entrega POST:** - `Content-Type: application/json` - `Accept: application/json` - `X-Reborn-Signature`: HMAC-SHA256 do body JSON bruto (UTF-8), em hexadecimal minúsculo, usando o `secret` do webhook **Validação:** `expected = HMAC_SHA256(secret, rawBody)` → compare com `X-Reborn-Signature` usando comparação constante (timing-safe). Não re-serialize o JSON parseado. **Formato do body (eventos de transação):** ```json { "type": "TRANSACTION_PAID", "sellerId": "uuid", "occurredAt": "2026-06-18T02:14:56", "data": { "transaction": { /* mesmo schema de GET /v1/transactions/{id} */ } } } ``` Eventos de teste incluem `"test": true`.

Headers

X-Api-Keystringrequired

API Key do seller (header)

Path Parameters

sellerIdstringrequired

Body

application/json

urlstringrequired

URL HTTPS que receberá as notificações via POST

eventTypesstringrequired

Eventos a serem notificados. Use ALL para receber todos os eventos. Eventos disponíveis: - TRANSACTION_PAID: pagamento aprovado - TRANSACTION_CANCELLED: transação cancelada - TRANSACTION_REFUNDED: estorno realizado - PAYMENT_LINK_CREATED: link de pagamento criado - PAYMENT_LINK_EXPIRED: link de pagamento expirado - SETTLEMENT_CREATED / SETTLEMENT_PAID: liquidação gerada/paga - CHARGEBACK_RECEIVED / CHARGEBACK_RESOLVED: chargeback

isActivebooleanoptional

Inicia o webhook ativo. Defina false para criar inativo.

descriptionstringoptional

Descrição interna para identificar o webhook

Responses

201Webhook criado — guarde o secret

webhookobjectrequired

Webhook configurado para o seller

idstring · uuidrequired

UUID do webhook

Example: 3fa85f64-5717-4562-b3fc-2c963f66afa6

sellerIdstring · uuidrequired

UUID do seller

Example: a1b2c3d4-e5f6-7890-abcd-ef1234567890

urlstringrequired

URL que recebe as notificações

Example: https://seuservidor.com/webhooks/rebornpay

eventTypesarrayrequired

Tipos de evento configurados

Example: ["TRANSACTION_PAID","TRANSACTION_CANCELLED"]

isActivebooleanrequired

Indica se o webhook está ativo

Example: true

descriptionstringoptional

Descrição interna do webhook

Example: Webhook de produção — ERP

createdAtstring · date-timerequired

Data de criação (UTC)

updatedAtstring · date-timerequired

Data da última atualização (UTC)

secretstringrequired

Secret HMAC-SHA256 para validar as requisições recebidas. Exibido apenas uma vez.

Example: whsec_a1b2c3d4e5f6...

401API Key ausente ou inválida

webhookobjectrequired

Webhook configurado para o seller

idstring · uuidrequired

UUID do webhook

Example: 3fa85f64-5717-4562-b3fc-2c963f66afa6

sellerIdstring · uuidrequired

UUID do seller

Example: a1b2c3d4-e5f6-7890-abcd-ef1234567890

urlstringrequired

URL que recebe as notificações

Example: https://seuservidor.com/webhooks/rebornpay

eventTypesarrayrequired

Tipos de evento configurados

Example: ["TRANSACTION_PAID","TRANSACTION_CANCELLED"]

isActivebooleanrequired

Indica se o webhook está ativo

Example: true

descriptionstringoptional

Descrição interna do webhook

Example: Webhook de produção — ERP

createdAtstring · date-timerequired

Data de criação (UTC)

updatedAtstring · date-timerequired

Data da última atualização (UTC)

secretstringrequired

Secret HMAC-SHA256 para validar as requisições recebidas. Exibido apenas uma vez.

Example: whsec_a1b2c3d4e5f6...

403Sem permissão para acessar este seller

webhookobjectrequired

Webhook configurado para o seller

idstring · uuidrequired

UUID do webhook

Example: 3fa85f64-5717-4562-b3fc-2c963f66afa6

sellerIdstring · uuidrequired

UUID do seller

Example: a1b2c3d4-e5f6-7890-abcd-ef1234567890

urlstringrequired

URL que recebe as notificações

Example: https://seuservidor.com/webhooks/rebornpay

eventTypesarrayrequired

Tipos de evento configurados

Example: ["TRANSACTION_PAID","TRANSACTION_CANCELLED"]

isActivebooleanrequired

Indica se o webhook está ativo

Example: true

descriptionstringoptional

Descrição interna do webhook

Example: Webhook de produção — ERP

createdAtstring · date-timerequired

Data de criação (UTC)

updatedAtstring · date-timerequired

Data da última atualização (UTC)

secretstringrequired

Secret HMAC-SHA256 para validar as requisições recebidas. Exibido apenas uma vez.

Example: whsec_a1b2c3d4e5f6...

422URL inválida ou evento desconhecido

webhookobjectrequired

Webhook configurado para o seller

idstring · uuidrequired

UUID do webhook

Example: 3fa85f64-5717-4562-b3fc-2c963f66afa6

sellerIdstring · uuidrequired

UUID do seller

Example: a1b2c3d4-e5f6-7890-abcd-ef1234567890

urlstringrequired

URL que recebe as notificações

Example: https://seuservidor.com/webhooks/rebornpay

eventTypesarrayrequired

Tipos de evento configurados

Example: ["TRANSACTION_PAID","TRANSACTION_CANCELLED"]

isActivebooleanrequired

Indica se o webhook está ativo

Example: true

descriptionstringoptional

Descrição interna do webhook

Example: Webhook de produção — ERP

createdAtstring · date-timerequired

Data de criação (UTC)

updatedAtstring · date-timerequired

Data da última atualização (UTC)

secretstringrequired

Secret HMAC-SHA256 para validar as requisições recebidas. Exibido apenas uma vez.

Example: whsec_a1b2c3d4e5f6...

curl -X POST 'https://sandbox-api.rebornpay.io/v1/sellers/{sellerId}/webhooks' \  -H 'X-Api-Key: $API_KEY' \  -H 'Content-Type: application/json'

201Response example

{
  "webhook": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "sellerId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "url": "https://seuservidor.com/webhooks/rebornpay",
    "eventTypes": [
      "TRANSACTION_PAID",
      "TRANSACTION_CANCELLED"
    ],
    "isActive": true,
    "description": "Webhook produção",
    "createdAt": "2025-01-15T10:30:00",
    "updatedAt": "2025-01-15T10:30:00"
  },
  "secret": "whsec_a1b2c3d4e5f6..."
}