Events
Outgoing webhook events sent by Cobrofácil.
Webhook ping
Test event sent when you manually send a ping from the webhook menu.
- Name
id- Type
- string
- Details
- required
- example: f745dd90-4e4f-11f1-868c-710e65f6348b
- Description
Unique delivery group ID for the event. Retries for the same event use the same value.
- Name
event- Type
- string
- Details
- required
- enum: webhook.ping
- example: webhook.ping
- Description
Webhook event name.
- Name
created_at- Type
- string
- Details
- required
- example: 2026-05-26T18:42:15.000000Z
- Description
ISO 8601 timestamp for when Cobrofácil created the webhook payload.
- Name
data- Type
- object
- Details
- required
- Description
Event-specific data.
Payload
{
"id": "f745dd90-4e4f-11f1-868c-710e65f6348b",
"event": "webhook.ping",
"created_at": "2026-05-26T18:42:15.000000Z",
"data": {}
}
SPEI transfer reconciled
Sent when an outgoing SPEI transfer moves from cleared to reconciled.
- Name
id- Type
- string
- Details
- required
- example: f745dd90-4e4f-11f1-868c-710e65f6348b
- Description
Unique delivery group ID for the event. Retries for the same event use the same value.
- Name
event- Type
- string
- Details
- required
- enum: spei_transfer.reconciled
- example: spei_transfer.reconciled
- Description
Webhook event name.
- Name
created_at- Type
- string
- Details
- required
- example: 2026-05-26T18:42:15.000000Z
- Description
ISO 8601 timestamp for when Cobrofácil created the webhook payload.
- Name
data- Type
- object
- Details
- required
- Description
Event-specific data.
- Name
data.id- Type
- string
- Details
- required
- example: 01HZY0Q7J3S2K6V77E9B8F3V2M
- Description
SPEI transfer ID.
- Name
data.tracking_id- Type
- string
- Details
- required
- example: TEST-WEBHOOK-12345678
- Description
SPEI tracking key.
- Name
data.provider_id- Type
- integer
- Details
- required
- example: 123456
- Description
Provider transfer ID.
- Name
data.order_type- Type
- integer
- Details
- required
- enum: 1 | 2
- example: 2
- Description
SPEI order type.
- Name
data.status- Type
- integer
- Details
- required
- enum: 0 | 1 | 2 | 3 | 4
- example: 4
- Description
SPEI transfer status.
- Name
data.clearing_date- Type
- string
- Details
- required
- nullable
- example: 2026-05-26T18:32:15.000000Z
- Description
Date and time when the transfer was cleared.
- Name
data.reconciled_date- Type
- string
- Details
- required
- nullable
- example: 2026-05-26T18:42:15.000000Z
- Description
Date and time when the transfer was reconciled.
- Name
data.capturing_date- Type
- string
- Details
- required
- nullable
- example: null
- Description
Date and time when the transfer was captured.
- Name
data.external_reference- Type
- string
- Details
- required
- nullable
- example: client-300
- Description
Client external reference.
- Name
data.account_id- Type
- string
- Details
- required
- nullable
- example: 01HZY0Q7J3S2K6V77E9B8F3V2M
- Description
Account ID associated with the transfer.
- Name
data.client_id- Type
- string
- Details
- required
- nullable
- example: 01HZY0Q7J3S2K6V77E9B8F3V2M
- Description
Client ID associated with the transfer.
- Name
data.client_display- Type
- string
- Details
- required
- nullable
- example: Juan Mejía
- Description
Client display name.
- Name
data.amount- Type
- number
- Details
- required
- example: 1000
- Description
Transfer amount.
- Name
data.numeric_reference- Type
- integer
- Details
- required
- example: 1234567
- Description
Numeric reference assigned to the transfer.
- Name
data.sender_bank_id- Type
- integer
- Details
- required
- example: 90646
- Description
Sender bank identifier.
- Name
data.recipient_bank_id- Type
- integer
- Details
- required
- example: 40012
- Description
Recipient bank identifier.
- Name
data.sender_clabe- Type
- string
- Details
- required
- example: 646180630700000001
- Description
Sender CLABE.
- Name
data.recipient_clabe- Type
- string
- Details
- required
- example: 012345678901234568
- Description
Recipient CLABE.
- Name
data.sender_name- Type
- string
- Details
- required
- example: STP
- Description
Sender name.
- Name
data.concept- Type
- string
- Details
- required
- nullable
- example: SPEI webhook reconciliation test
- Description
Transfer concept.
- Name
data.cep_url- Type
- string
- Details
- required
- nullable
- example: https://www.banxico.org.mx/cep/...
- Description
BANXICO CEP URL.
Payload
{
"id": "f745dd90-4e4f-11f1-868c-710e65f6348b",
"event": "spei_transfer.reconciled",
"created_at": "2026-05-26T18:42:15.000000Z",
"data": {
"id": "01HZY0Q7J3S2K6V77E9B8F3V2M",
"tracking_id": "TEST-WEBHOOK-12345678",
"provider_id": 123456,
"order_type": 2,
"status": 4,
"clearing_date": "2026-05-26T18:32:15.000000Z",
"reconciled_date": "2026-05-26T18:42:15.000000Z",
"capturing_date": null,
"external_reference": "client-300",
"account_id": "01HZY0Q7J3S2K6V77E9B8F3V2M",
"client_id": "01HZY0Q7J3S2K6V77E9B8F3V2M",
"client_display": "Juan Mejía",
"amount": 1000,
"numeric_reference": 1234567,
"sender_bank_id": 90646,
"recipient_bank_id": 40012,
"sender_clabe": "646180630700000001",
"recipient_clabe": "012345678901234568",
"sender_name": "STP",
"concept": "SPEI webhook reconciliation test",
"cep_url": "https://www.banxico.org.mx/cep/..."
}
}