Account Transaction Created

Notification of an account transaction.

Overview

This webhook will be triggered when the wallet/bank account balance changes for any reason, such as the below events:

1 The clearance process will generate 2x webhooks per-scheme, which will be sent:

  • After the clearance process has taken place for that scheme
  • Once Viva Wallet’s fees have been deducted

2 The webhook will relate to the account in which the funds are deducted - i.e. the account to which the card is linked

Webhook configuration

To enable in the Viva Wallet banking app:

  1. Log in to Viva Wallet, demo or live , and select the required account.

  2. Visit Settings > API Access > Webhooks.

  3. Click on the Create Webhook link.
    The New Webhook dialog box is displayed.

  4. Enter your webhook URL in the URL field.

  5. Click on the Verify link.
    If verified successfully, a confirmation message is displayed.

  6. Choose Account Transaction Created from the Event Type dropdown:

    Account Transaction webhook

  7. Select the Active checkbox to activate notifications.

  8. Click on the Save button.

Response example

You may find below the sample response with EventTypeId 2054.

{
  "Url": "Your webhook URL",
  "EventData": {
    "Iban": null,
    "PersonId": "11ac9cd4-c9ea-48d3-b414-1f10ce664aad",
    "WalletId": 2263446434318,
    "BankId": null,
    "ParentId": "a787e1bb-8101-4043-8618-3b962d8f6cfc",
    "Amount": -100.4, //Amount in EUR, GBP, ZLOTY, ETC.
    "IsInternal": false,
    "StatusId": "F",
    "Created": "2022-05-26T03:01:42.457",
    "CardNumber": null,
    "Description": "Wallet2Wallet Transfer - Merchant Trade Name - [Optional text to show on account statement]",
    "ValueDate": null,
    "BankAccountId": null,
    "CurrencyCode": "978",
    "TargetAmount": 10,
    "SaleTransactionId": null,
    "TargetReserved": 0,
    "TargetAvailable": 10,
    "TargetOverdraft": 0,
    "WalletTransactionId": "6fb74d4a-aa92-4920-a759-49a703834c03",
    "InternalDescription": null,
    "TypeId": 20,
    "SubTypeId": 140
  },
  "Created": "2022-05-26T00:01:42.4752623Z",
  "CorrelationId": "22-146-51FB37DB",
  "EventTypeId": 2054,
  "Delay": null,
  "MessageId": "82606171-a5a3-4330-8a86-548b4344f451",
  "RecipientId": "11ac9cd4-c9ea-48d3-b414-1f10ce664aad",
  "MessageTypeId": 512
}

Webhook body

You can find below the body parameters of this webhook

Parameter Description Example
Amount (decimal) The signed amount of the transaction. Represents the total funds paid by the customer and includes TotalFee (when applicable) -100.4
BankAccountId (uuid) null
BankId (string) Bank's ID null
CardNumber (string) The card number used (applicable for card related transaction types) null
Created (datetime) Transaction's creation timestamp "2021-11-04T17:30:24.363"
CurrencyCode (string) The currency of the transaction in ISO 4217 numeric format (e.g. “978” for Euro) "978"
Description (string) This description is related to the wallet transaction "Μεταφορά Wallet2Wallet - George Mitsiou - Test Description"
Iban (string) The Iban the wallet owner sent a bank transfer to null
InternalDescription (string) This description is related to the wallet transaction null
IsInternal (boolean) True, if the wallet Trn was created through internal viva wallet operations false
ParentId (uuid) The parent TransactionId (if any) of the current transaction "d1b9242b-5665-44a0-903b-7325b235ca2f"
PersonId (uuid) The Id of the person/merchant that initiated the action, or who billing created an obligation for "bdf4c6b3-c26d-4046-b5df-5c443ec39d09"
SaleTransactionId (uuid) The core transaction which is matched to the wallet transaction which generated this event. (e.g. a paid order which resulted in a balance change of a wallet) null
StatusId (string) The status of the transaction "F"
SubTypeId (uuid) The wallet subtypeId 140
TypeId (uuid) The wallet typeId 20
ValueDate (datetime) The settlement date of the bank transfer, if the wallet Trn was created from a bank transfer null
WalletId (uuid) The wallet from which the transaction was initiated 657297971060
WalletTransactionId (uuid) The Id of the wallet transaction that was created as a result of this transaction "ea312e33-25ef-4858-886f-6298898f4249"
EventTypeId (int) The type of the event that triggered the notification 2054
MessageId (uuid) Unique identifier of the message "5798c886-6ad7-40ea-bb3f-4b12f16b195b"

Get Support

If you would like to integrate with Viva Wallet, or if you have any queries about our products and solutions, please see our Get Support page to see how we can help!