Wallet events

Vendy sends these events when money is paid into an account number you own.

Event	Sent when
`virtual_account_funded`	A customer pays into one of your dedicated accounts
`wallet_funded`	Someone pays into a wallet's own account number

The request has an x-signature header. See Validating Webhook Signatures.

virtual_account_funded

Field	Type	Description
`amount`	String	Amount received
`currency`	String	ISO 4217 code
`virtualAccountId`	Integer	The dedicated account's `id`
`accountNumber`	String	The dedicated account number
`customerName`	String	The customer the account belongs to
`accountName`	String	The account name
`bankName`	String	The bank
`comment`	String	The bank's narration
`payer`	String	The sender, as reported by the bank
`refid`	String	Vendy reference for this inflow
`date`	String	When Vendy received it

{
    "event.type": "virtual_account_funded",
    "data": {
        "amount": "3000.0",
        "currency": "NGN",
        "virtualAccountId": 6,
        "accountNumber": "9012345678",
        "customerName": "Ada Okafor",
        "accountName": "Ada's Store Ada Okafor",
        "bankName": "FCMB",
        "comment": "CREDIT OF NGN3000.00 FROM GTBank(Tester Name - 0123****789) TO Vendy Ada's Store Ada Okafor(9012****678)",
        "payer": "Tester Name - 0123****789",
        "refid": "VND-WLT-90380388708828553368894020813856",
        "date": "Oct 20, 2026 5:22 PM"
    }
}

wallet_funded

Note the lowercase accountname and bankname in this event.

Field	Type	Description
`amount`	String	Amount received
`currency`	String	ISO 4217 code
`walletId`	Integer	The wallet that was credited
`accountNumber`	String	The wallet's account number
`accountname`	String	The account name
`bankname`	String	The bank
`comment`	String	The bank's narration
`payer`	String	The sender, as reported by the bank
`refid`	String	Vendy reference for this inflow
`date`	String	When Vendy received it

{
    "event.type": "wallet_funded",
    "data": {
        "amount": "3000.0",
        "currency": "NGN",
        "walletId": 2282,
        "accountNumber": "9012345678",
        "accountname": "Ada's Store",
        "bankname": "FCMB",
        "comment": "CREDIT OF NGN3000.00 FROM GTBank(Tester Name - 0123****789) TO Vendy Ada's Store(9012****678)",
        "payer": "Tester Name - 0123****789",
        "refid": "VND-WLT-90380388708828553368894020813856",
        "date": "Oct 20, 2026 5:22 PM"
    }
}