WebhooksEventos
Eventos de Submerchants
Lista completa de eventos de webhook relacionados a submerchants, com descrições e exemplos de payload.
Eventos disponíveis
| Evento | Descrição |
|---|---|
submerchant.approved | Submerchant aprovado e habilitado para transações |
submerchant.rejected | Submerchant rejeitado na análise |
submerchant.suspended | Submerchant suspenso temporariamente |
Quando cada evento dispara
submerchant.approved
Disparado quando um submerchant em status pending, pending_review ou suspended é aprovado pela equipe SoarLabz. O submerchant fica habilitado para realizar transações e todos os documentos pendentes são aprovados automaticamente.
submerchant.rejected
Disparado quando um submerchant em status pending ou pending_review é rejeitado na análise. O campo review_notes contém o motivo da rejeição. O merchant pode corrigir os dados e reenviar para nova análise.
submerchant.suspended
Disparado quando um submerchant ativo é suspenso temporariamente. O submerchant fica impossibilitado de realizar novas transações até ser reativado.
Payload de exemplo
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"event": "submerchant.approved",
"submerchant": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"parent_merchant_id": "m1e2r3c4-h5a6-7890-ntid-000000000001",
"trade_name": "Loja do João",
"legal_name": "João Silva ME",
"tax_id": "12345678000199",
"email": "joao@lojadojoao.com",
"status": "active",
"review_notes": null,
"reviewed_at": "2026-03-30T14:00:00.000Z",
"created_at": "2026-03-25T10:00:00.000Z",
"updated_at": "2026-03-30T14:00:00.000Z"
},
"occurred_at": "2026-03-30T14:00:00.000Z"
}Campos do objeto submerchant
| Campo | Tipo | Descrição |
|---|---|---|
id | string | ID único do submerchant |
parent_merchant_id | string | ID do merchant pai |
trade_name | string | Nome fantasia |
legal_name | string | Razão social |
tax_id | string | CPF ou CNPJ |
email | string | Email do submerchant |
status | string | Status atual (active, rejected, suspended) |
review_notes | string | null | Motivo da rejeição ou suspensão |
reviewed_at | string | null | Data/hora da análise (ISO 8601) |
created_at | string | Data/hora da criação (ISO 8601) |
updated_at | string | Data/hora da última atualização (ISO 8601) |