Events

Webhook events

Types of events

	description
	There's a transaction between two Fintava wallets
	Your wallet has been credited from an external bank
	A customer wallet has either been credited or there was a reversal from Fintava

Wallet to wallet v2:

This occurs when there's a transaction between two Fintava wallets.

{
  event: 'wallet_to_wallet_transfer_v2',
  data: {
    amount: 10,
    reference: '48VYIuIAZTSVQlZ8O900JdcUJ0imoVZ1L',
    total: 10,
    transaction_fee: 0,
    target_customer_id: 'dc4d9318-e145-000c-00a8-c251997345c0',
    source_customer_id: 'b2ce958b-2b3c-4004-0089-c064f346b9f7',
    target_customer_accname: 'ArewaPay/john doe',
    source_customer_accname: 'john services limited',
    target_customer_accno: '0040497763',
    source_customer_accno: '0020886993',
    source_customer_wallet: '0031886994',
    target_customer_wallet: '0032497867',
    target_availableBalance: 22,
    target_bookedBalance: 22,
    source_availableBalance: 187,
    source_bookedBalance: 187,
    description: 'Fund transfer between customers',
    customer_id: 'ba67c2cl-4894-0001-91b1-e7c5e3fa2b08'
  }
}

account_funded

Your wallet has been credited from an external bank

{
  event: 'account_funded',
  data: {
    userId: 'bf61c3cf-4894-4a01-91b1-e4c5e2fa2b08',
    amount: '100.00',
    reference: '000014231211154211281900319598',
    senderBankSortcode: '000014',
    sessionID: '000914231311144221237185422093',
    channelCode: '3',
    status: 'success',
    accountName: 'john doe',
    beneficiaryAccountName: "joe services Limited",
    beneficiaryAccountNumber: "0094886003",  
    accountNumber: '0865231291',
    BankVerificationCode: '22000000039'
  }
}

customer_wallet_credited

A customer wallet has either been credited or there was a reversal from Fintava

{
  event: 'customer_wallet_credited',
  data: {
    amount: 120,
    reference: '1702306209792',
    customer_id: 'bf61c2cf-4893-4a01-91b1-e7c5e2fa2b18',
    customer_availableBalance: 266.25,
    customer_bookedBalance: 266.25,
    customer_wallet_id: '0084886292',
    transaction_fee: 0
  }
}

VIRTUAL_WALLET_PAYMENT

Transactions on the virtual wallets are sent through this events.

{
  "event": "VIRTUAL_WALLET_PAYMENT",
  "data": {
    "id": "6117ef41-a058-4f16-0000-14f4561ec35b",
    "customerName": "john doe",
    "merchantReference": "9TTEER288282882818",
    "expireTimeInMin": 30,
    "description": "test",
    "metadata": null,
    "amount": "650.00",
    "phone": "09070729756",
    "email": "[email protected]",
    "bank": "Loma Bank",
    "virtualAcctName": "Google Inc limited/Fintava",
    "virtualAcctNo": "1164658900",
    "requestTime": "2024-03-15T14:06:07.473Z",
    "status": "PAID",
    "paymentStatus": "PAID"
  }
}

debit_transfer_reversal

An event to initiate reversal for failed transactions

{
  event: "debit_transfer_reversal",
  data: {
    amount: 100000,
    charges: 15,
    vat: 0,
    accountName: "Abc Nigeria Ltd",
    accountNumber: "00126",
    customerId: "dd3d6-72d-48b9-bb45-29d78b52a",
    customerReference: "f93fc-f4ef-473c-9817-4e2c3",
    type: "CREDIT",
    status: "success",
    total: 100015,
    transactionReference: "ref/0906205451400533/tyqwA0xLFhqDX9BWSgzGb0C",
    description: "transfer",
    destination: "5509704/090405",
    reversalRef: "r-tyqwA0xLFh2ifNhDX9BWSgzGb0C"
  }
}

customer_bank_transfer

An event for bank transfers

{
  event: customer_bank_transfer,
  data: {
    amount: 100.0,
    vat: 0,
    reference: 2e076e1-019a-4a3c-b1a6-65b0d98,
    customerId: e17402-0d82-4774-a020-716d819d0,
    availableBalance: 109.5199999968,
    bookedBalance: 109.5199999968,
    status: SUCCESS,
    total: 130.75,
    description: payment,
    destination: 81450/100004,
    sessionID: 1106110503777587020112,
    CustomerReference: FIO241106308911000370001675,
    senderName: ADF Limited,
    senderAccountNumber: 0000037726,
    charges: 30.75
  }
}