---
title: "Send event webhook"
method: POST
path: "/merchant_url/webhook"
tags: ["notifications"]
---

# Send event webhook

`POST /merchant_url/webhook`

## Request body

- WebhookPayload
  - `verify_token` string, required
  - `events` Event[], required
    - `event_type` 'payin.rejected' | 'payin.settled' | 'payout.initiated' | 'payout.settled' | 'payout.failed' | 'payout.cancelled', required
    - `event_id` string, uuid, required
    - `timestamp` string, date-time, required
    - `payload` Payload, required
      - `amount` string, required
      - `concept` string, required
      - `currency` string, required
      - `id` string
      - `transaction_id` string
      - `external_id` string
      - `origin` AccountDetails
        - `account_number` string, required
        - `branch` string
        - `owner_name` string
        - `account_format` 'iban' | 'clabe' | 'cci' | 'pix' | 'bre_b' | 'alias' | 'cbu' | 'cvu' — The type of account
        - `tax_id_type` 'rfc' | 'cnpj' | 'cpf' | 'ruc' | 'curp' | 'le' | 'dni' | 'lm' | 'pas' | 'ce' | 'nit' | 'cc' | 'pa' | 'ti' | 'nuip' | 'ppt' | 'pep' | 'cuil' | 'cuit' | 'other' — The type of tax identification of the customer
        - `tax_id` string — The customer's tax identification number
        - `bank` Bank
          - `code` string — The bank code number
          - `bicfi` string — The bank BICFI code
          - `name` string — The bank name
          - `country` string — ISO-3166-1 Alfa-2 country code
      - `destination` AccountDetails
        - `account_number` string, required
        - `branch` string
        - `owner_name` string
        - `account_format` 'iban' | 'clabe' | 'cci' | 'pix' | 'bre_b' | 'alias' | 'cbu' | 'cvu' — The type of account
        - `tax_id_type` 'rfc' | 'cnpj' | 'cpf' | 'ruc' | 'curp' | 'le' | 'dni' | 'lm' | 'pas' | 'ce' | 'nit' | 'cc' | 'pa' | 'ti' | 'nuip' | 'ppt' | 'pep' | 'cuil' | 'cuit' | 'other' — The type of tax identification of the customer
        - `tax_id` string — The customer's tax identification number
        - `bank` Bank
          - `code` string — The bank code number
          - `bicfi` string — The bank BICFI code
          - `name` string — The bank name
          - `country` string — ISO-3166-1 Alfa-2 country code
      - `voucher_data` VoucherDataEvent
        - `key_tracing` string
        - `url` string
      - `error` PayloadError
        - `code` string
        - `message` string

## Response `200`

Webhook received successfully

---

[API](https://skmtc.net/prometeoapi/apis/account-validation-v2.md) · [All operations](https://skmtc.net/prometeoapi/apis/account-validation-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/prometeoapi/account-validation-v2/revisions/9c278fe91cbd/schema)