Skip to main content

Documentation Index

Fetch the complete documentation index at: https://doc.raliopay.com/llms.txt

Use this file to discover all available pages before exploring further.

​
vIBAN Deactivated

Event Name: viban_deactivated
This event signifies that a previously ACTIVE Virtual IBAN has been deactivated. The associated iban will no longer accept incoming transfers. Any payments sent to it after this event will not be credited.

​
Event Payload

The webhook payload contains the following structure: 
{
  "eventId": "f1e2d3c4-b5a6-7980-1234-567890abcdef",
  "eventType": "viban_deactivated",
  "timestamp": "2026-05-10T12:34:56.789Z",
  "data": {
    "vibanId": "7a1f3c5b-2d8e-4f0a-9b6c-1e3d4f5a6b7c",
    "accountId": "4c2b8e5d-1f6a-4e7c-9d3b-2a8f5c1e9b4d",
    "rail": "SEPA",
    "status": "INACTIVE",
    "iban": "DE89370400440532013000"
  }
}

​
Payload Fields

​
eventId
string
required
Unique identifier for this webhook event
​
eventType
string
required
Event type — always viban_deactivated for this webhook
​
timestamp
string
required
ISO 8601 timestamp indicating when the event occurred
​
data
object
required
Event-specific payload

​
Expected Responses

Success Response

HTTP 200 OKThe webhook was processed successfully.

Client Error

HTTP 4xx StatusClient-side error. Will not be retried.

Server Error

HTTP 5xx StatusServer-side error. Will be retried with exponential backoff.

​
Implementation Example

app.post('/webhooks/ralio', async (req, res) => {
  const { eventType, data } = req.body;

  if (eventType === 'viban_deactivated') {
    const { vibanId, accountId, iban } = data;
    console.log(`vIBAN ${vibanId} deactivated on account ${accountId}`);

    // Stop offering this IBAN to end users
    await markVibanInactive(vibanId, iban);

    return res.status(200).json({ received: true });
  }
});