Get automatic updates and information on virtual accounts
Virtual Accounts Webhook Notification API service provides a seamless way to stay updated with real-time events and transactions related to your virtual accounts. Instead of manually polling APIs, webhooks push instant notifications directly to your application whenever specific actions occur, enabling faster and automated responses.
Webhook notification provides you with information on:
{status: "OK"}.{
"svWebhookNotificationServiceRQ": {
"company": [
{
"companyCode": "1101",
"notifications": [
{
"type": "CREDIT", // CREDIT/DEBIT
"timestamp": "2025-08-01T05:49:52.715Z",
"AccountNumber": SA5100012680407123456789,
"acERPcode": "T1T2",
"Amount": 11000,
"Currency": "SAR",
"CustomerRefNo": 123247908,
"TransactionReference": 123456789247908,
"Description": "Incoming internal transfer",
"TransactionSource": 14000001122337408,
"ValueDate": 230621,
"DateTime": 2306211622,
"RemitterId": "20050162914321"
}
]
}
]
}
}Response description:
JSON Tag | Description | Data type |
|---|---|---|
svWebhookNotificationServiceRQ | Root tag containing webhook notification response | Object |
company | Tag carrying information about the company | Object |
companyCode | Unique company identification code | String |
notification | Tag carrying information on the transaction | Object |
type | Type of transaction in the account mentioned as | Alphabetic |
timestamp | Date and time of transaction in | Date |
AccountNumber | Virtual account identification number | Alphanumeric |
acERPcode | Unique account identification code linked in ERP | Alphanumeric |
Amount | Transaction amount | Numeric |
Currency | Currency of the transaction | Alphabetic |
CustomerRefNo | Unique customer reference number for the transaction | String |
TransactionReference | Unique transaction reference number | String |
Description | Details about the transaction | String |
TransactionSource | Unique transaction source identification details | String |
ValueDate | Date representing the transaction initiation | Numeric |
DateTime | Date and time representing the transaction settlement | Numeric |
RemitterId | Unique remitter identification details | String |
{
Status:"OK"
}