Transaction Failed

The purpose of this webhook is to notify you that a customer payment has been declined by their issuing bank.

Webhook configuration

To enable within 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 Transaction Failed from the Event Type dropdown:

    Transaction Failed webhook

  7. Select the Active checkbox to activate notifications.

  8. Click on the Save button.

Webhook response

You may find below the sample response with EventTypeId 1798.

Response example

    "Moto": false,
    "Email": "",
    "Phone": null,
    "BankId": "NET_VISA",
    "Systemic": false,
    "Switching": false,
    "ParentId": null,
    "Amount": 99.05,
    "ChannelId": "245a790d-c98d-4d80-ad97-a9b1efb5771e",
    "TerminalId": 90000000,
    "MerchantId": "bdf4c6b3-c26d-4046-b5df-5c443ec39d09",
    "OrderCode": 5039420255772601,
    "ProductId": null,
    "StatusId": "E",
    "FullName": "George Mitsiou",
    "ResellerId": null,
    "InsDate": "2021-11-04T17:06:02.153",
    "TotalFee": 0,
    "CardToken": "2BFCB1FD4F000DB41CB5BA76CAFB68D76AB87752",
    "CardNumber": "414746XXXXXX0133",
    "TipAmount": 0,
    "SourceCode": 8362,
    "SourceName": "Test",
    "Latitude": null,
    "Longitude": null,
    "CompanyName": "Greek Services",
    "TransactionId": "92e0debb-fdf4-4392-a940-290b0c62ea6b",
    "CompanyTitle": "Greek Services",
    "PanEntryMode": 01,
    "ReferenceNumber": 981049,
    "ResponseCode": 05,
    "CurrencyCode": 978,
    "OrderCulture": "el-GR",
    "MerchantTrns": "Short description of items/services purchased by customer with installments",
    "CustomerTrns": "Carpet Cleaning Services",
    "IsManualRefund": false,
    "TargetPersonId": null,
    "TargetWalletId": null,
    "LoyaltyTriggered": false,
    "TransactionTypeId": 5,
    "TotalInstallments": 0,
    "CardCountryCode": "SG",
    "CardIssuingBank": "CITIBANK",
    "RedeemedAmount": 0,
    "ClearanceDate": null,
    "CurrentInstallment": 0,
    "Tags": [],
    "BillId": null,
    "ResellerSourceCode": null,
    "ResellerSourceName": null,
    "ResellerCompanyName": null,
    "ResellerSourceAddress": null,
    "CardExpirationDate": "2027-12-31T00:00:00",
    "RetrievalReferenceNumber": 130815981049,
    "AssignedMerchantUsers": [],
    "AssignedResellerUsers": [],
    "CardTypeId": 0,
    "ResponseEventId": 10005,
    "ElectronicCommerceIndicator": 7