Use webhooks to get notified about events that happen in your Vella account.

Transaction Verification

After a charge is completed successfully, you should verify that the payment was successful with Vella before giving value to your customer in your application. This is to ensure that the payment that was made is the payment you expected.

Important checks for payment verification:

  • Verify that the transaction reference matches the one you generated
  • Verify that the status of the transaction is successful or completed.
  • Verify that the amount paid is equal to the amount you expect.


Always verify the transaction

You should always verify the payment on your server afterwards, even if you used a callback.

curl --location -g --request GET '{reference}/verify' \
--header 'Authorization: Bearer vk_test_T7P3WBujxcEGJbyM25vxOuq4Q4vCMBgQXXXXXxx'

Sample Response

  "data": {
    "account": {
      "id": "000000000",
    "amount": "100",
    "total": "101.5",
    "reference": "VEPXXXXXXXXXXXXXXX",
    "settlement": {
      "currency": "NGN"
    "narration": "Credit - Received 100 NGN via Vella Checkout",
    "status": "successful",
    "customer": {
      "name": "Taje Ade",
      "email": "[email protected]"
    "payment_type": "card",
    "trnx_ref": "VEPXXXXXXXXX",
    "meta_data": "NULL