Skip to main content

​
How webhooks work in Archefusion

Archefusion webhook event flow Integrating multiple payment gateways (Paystack, Flutterwave, Interswitch, etc.) individually means you have to set up a webhook URL for each and verify them. However, with Archefusion, you only set up a single webhook URL. Archefusion receives every event from each of these gateways on your behalf, verifies it, and sends the event to your server. That way, you do not need to independently set up or verify events from different gateways; Archefusion handles it for you.

​
How to configure your webhook URL in Archefusion

This allows Archefusion to receive webhook events from all your configured gateways on your behalf.
  1. Log in to your merchant account.
  2. Navigate to “Payment Gateways” > “Gateway Providers” > “My Gateway.”
  3. Select one of your configured gateways and copy the webhook URL.
For example, if you select Flutterwave, copy the webhook URL from your Flutterwave configuration page.Archefusion webhook URL for Flutterwave
  1. Paste the webhook URL in your provider dashboard so Archefusion can receive payment notifications on your behalf.
For example, if you copy the Flutterwave webhook URL, paste it in your Flutterwave dashboard under “Settings” > “Webhooks.”
  1. Repeat steps 3 and 4 for each payment gateway you configured.
  1. Navigate to “Settings” > “API Keys,” and scroll to the “Webhooks” section.
  2. Paste your webhook URL in the “Webhook” field and click “Save.” Archefusion will send all payment event notifications to this URL. Archefusion webhook configuration
  3. Click the “Get New Secret” button to get your webhook secret. You will use it to verify that every notification you receive is genuinely from Archefusion.
Your webhook secret is only generated once. Therefore, you have to securely store it.

​
A few things to note:

  • Your webhook URL must be a POST endpoint.
  • Your webhook URL must be a live URL (localhost cannot receive events).
  • Your webhook URL must return a 200 OK HTTP response. For more information about Archefusion webhook events, retries, and how to verify them, visit the handle webhook notifications page.

Next step

Create a payment intent to start accepting payments through your configured gateways using your smart routing rules.