Webhooks
Webhook Event Reference
Use webhook event types to update orders, payouts and support workflows.
EventsJSON payloadsIdempotent processing
Event reference
| Event type | Object | Description |
|---|---|---|
transaction.succeeded | Transaction | A payment completed successfully. |
transaction.failed | Transaction | A payment failed. |
transaction.cancelled | Transaction | A payment was cancelled. |
refund.succeeded | Refund | A refund completed. |
payout.created | Payout | A payout request was created. |
payout.paid | Payout | A payout completed. |
payout.failed | Payout | A payout failed. |
reader.action_cancelled | Reader | A terminal action was cancelled. |
Example transaction event
{
"id": "evt_nero_123",
"type": "transaction.succeeded",
"created_at": "2026-04-22T03:40:15+01:00",
"account_id": "NP6454f52b_6165",
"transaction": {
"id": 6636598,
"trx": "NP-ORDER1001",
"status": "succeeded",
"amount": "15.99",
"currency": "GBP",
"reference": "ORDER-1001"
}
}Example payout event
{
"id": "evt_nero_456",
"type": "payout.paid",
"created_at": "2026-04-22T09:10:15+01:00",
"account_id": "NP6454f52b_6165",
"payout": {
"id": 148468,
"status": "paid",
"amount": "25.00",
"currency": "GBP",
"reference": "SUPPLIER-1001"
}
}