Back to Payments
CRITICALHappy Path

Payment Webhook Processing

Verify that payment provider webhooks are correctly received and processed, updating order status automatically.

5 steps
~5 min
payment-13

Preconditions

  • Payment gateway is configured
  • Webhook endpoint is set up in payment provider dashboard
  • Access to backend logs or webhook testing tools

Test Data

Use Paystack CLI, Flutterwave webhook tester, or payment provider dashboard to simulate events.

Test Steps

Follow each step carefully

0/5

Complete a payment on the storefront

Verify

Payment is processed, confirmation shown

Check the payment provider dashboard

Location

Paystack/Flutterwave Dashboard > Webhooks or Events

Verify

Webhook event is logged as sent

Verify webhook was received by the backend

Location

Check backend logs or webhook logs in admin

Verify

Webhook receipt is logged with event type

Note

Look for logs like "Received webhook: charge.success"

Verify order status was updated

Location

Check the order in store admin

Verify

Order payment status reflects the webhook event

Verify payment record was created

Location

Payment details section of the order

Verify

Transaction ID and payment details are recorded

Expected Result

Webhook processing: (1) Webhook is received within seconds of payment, (2) Webhook signature is validated (not processed if invalid), (3) Order status automatically updates, (4) Payment transaction is recorded with provider reference, (5) Duplicate webhooks are handled idempotently, (6) Failed webhooks trigger retry mechanism.

Ready to Complete?

Click when you have verified all steps and the expected result.

Test Info

Module
Payments
Steps
5
Duration
5 min
XP Value
+50