> This page is for Internet banking (beta).

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.api.corpx.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.api.corpx.com/_mcp/server.

# boleto.charge.beneficiary.approved

POST 

Liquidante confirmou o cadastro do beneficiário de boleto da conta

O liquidante confirmou o cadastro do beneficiário de boleto da conta (ou a reativação de um relacionamento encerrado, com `reactivated: true`). A conta já pode emitir. `operationId` é o da resposta 202 do credenciamento. Os campos comuns aos quatro eventos de beneficiário são `accountId`, `beneficiaryId`, `operation` (`INCLUSION`, `UPDATE`, `STATUS_UPDATE` ou `TERMINATION`), `result` (`CONFIRMED` ou `REJECTED`), `operationId` e `occurredAt`. Veja o [guia de emissão de boleto](/baas/guias/cobranca/boleto-charge#acompanhando-o-beneficiário-por-webhook).

Reference: https://docs.api.corpx.com/ib/referencia/webhook-events/webhook-boleto-charge-beneficiary-approved

## Request

### Headers

- `X-Signature` (string, optional) — Present when the subscription uses `authType: HMAC`: `base64(HMAC_SHA256(secret, raw_request_body))` (standard Base64, with padding). Compare in constant time against your own computation over the raw body.

### Payload

- `id` (string, required) — Deterministic event id. Same `id` means the same event, possibly redelivered — deduplicate on it.
- `type` (enum, required) — Event type. Full list at `GET /v1/webhooks/events`.
  - Allowed values: `boleto.charge.beneficiary.approved`
- `occurredAt` (datetime, required) — RFC 3339, UTC with `Z`.
- `schemaVersion` (string, required) — `1.0` today; bumped only on breaking payload changes.
- `environment` (enum, required) — Environment that emitted the event.
  - Allowed values: `production`, `sandbox`
- `tenantId` (string, required) — Tenant the event belongs to.
- `data` (WebhooksWebhookBoletoChargeBeneficiaryApprovedPayloadContentApplicationJsonSchemaData, required) — Event-specific payload. See each webhook.
- `accountId` (string, optional) — CorpX account where the event happened. Empty on cross-account events.

## Types

### WebhooksWebhookBoletoChargeBeneficiaryApprovedPayloadContentApplicationJsonSchemaData

Event-specific payload. See each webhook.

- `accountId` (string, optional)
- `beneficiaryId` (string, optional)
- `operation` (string, optional)
- `result` (string, optional)
- `operationId` (string, optional)
- `occurredAt` (datetime, optional)
- `identifier` (string, optional)
- `reactivated` (boolean, optional)