Skip to main content
To get started, you need to configure each payment gateway you want to use via the Archefusion dashboard. This involves providing your API credentials for each gateway so Archefusion can connect to your gateway accounts and route payments through them on your behalf. Use your test credentials while in test mode, and switch to your live credentials before going live. Your credentials are securely encrypted and stored.
Visit the supported gateways and payment methods page to see a list of all supported payment gateways on Archefusion.

​
How to configure the Flutterwave gateway

Step 1: Log in to your merchant account, and navigate to “Payment Gateways” > “Gateway Providers” > “All Gateways.” Step 2: Scroll through the list and select “Flutterwave.” Step 3: Click the “Credentials” option and select the “Test” tab.
Only select the “Live” tab when you are ready to process real payments.
Step 4: Get your public key, secret key, and webhook secret from your Flutterwave dashboard, then paste them into the “Public Key,” “Secret Key,” and “Webhook Secret” fields, respectively. Flutterwave credentials page Step 5: Provide a reference prefix. This is added to the transaction reference for every payment processed through the Flutterwave gateway. For example, FW_ Step 6: Provide your redirect URL in the “Redirect URL” field. This is the URL on your server that Flutterwave redirects customers to after they complete payment on the checkout page. For example, your order confirmation or payment success page. Step 7: Click the “Save Changes” button to save your credentials. Save Flutterwave credentials Step 8: Click the “Test connection” button to test the gateway connection
This will automatically redirect you to the Flutterwave checkout page, and real funds will be processed, typically a small amount (e.g. ₦100), if you are in live mode.
Step 9: Complete the test payment. Once successful, you will be redirected to the redirect URL you provided in Step 6. Step 10: Navigate back to the Archefusion dashboard and click the “Add to my provider” button to add Flutterwave to your gateway list. Step 11: Toggle the gateway status to “active” to start routing payments through Flutterwave. Step 12: Copy the webhook URL displayed in the “Webhook URL” field and paste it into your Flutterwave dashboard under “Settings” > “Webhooks.” This allows Flutterwave to send payment event notifications to Archefusion on your behalf. Flutterwave webhook url

​
How to configure the Interswitch gateway

Step 1: Log in to your merchant account, and navigate to “Payment Gateways” > “Gateway Providers” > “All Gateways.” Step 2: Scroll through the list and select “Interswitch.” Step 3: Click the “Credentials” option and select the “Test” tab.
Only select the “Live” tab when you are ready to process real payments.
Step 4: Get your client ID, data reference, merchant code, pay item ID, secret key, and webhook secret from your Interswitch dashboard, then paste them into the “Client ID,” “Data Reference,” “Merchant Code,” “Pay Item ID,” “Secret Key,” and “Webhook Secret” fields, respectively. Interswitch credentials page
Ensure you enter each credential in the correct field to avoid errors.
Step 5: Provide a reference prefix. This is added to the transaction reference for every payment processed through the Interswitch gateway. For example, INTER_ Step 6: Provide your redirect URL in the “Redirect URL” field. This is the URL on your server that Interswitch redirects customers to after they complete payment on the checkout page. For example, your order confirmation or payment success page. Step 7: Click the “Save Changes” button to save your credentials. Save Interswitch credentials Step 8: Click the “Test connection” button to test the gateway connection.
This will automatically redirect you to the Interswitch checkout page, and real funds will be processed, typically a small amount (e.g. ₦100), if you are in live mode.
Step 9: Complete the test payment. Once successful, you will be redirected to the redirect URL you provided in Step 6. Step 10: Navigate back to the Archefusion dashboard and click the “Add to my provider” button to add Interswitch to your gateway list. Step 11: Toggle the gateway status to “active” to start routing payments through Interswitch. Step 12: Copy the webhook URL displayed in the “Webhook URL” field and paste it into your Interswitch dashboard under “Developer Tools” > “Webhooks.” This allows Interswitch to send payment event notifications to Archefusion on your behalf. Interswitch webhook url

​
How to configure the Monnify gateway

Step 1: Log in to your merchant account, and navigate to “Payment Gateways” > “Gateway Providers” > “All Gateways.” Step 2: Scroll through the list and select “Monnify.” Step 3: Click the “Credentials” option and select the “Test” tab.
Only select the “Live” tab when you are ready to process real payments.
Step 4: Get your contract code, API key, and secret key from your Monnify dashboard, then paste them into the “Contract Code,” “API Key,” and “Secret Key” fields, respectively. Monnify credentials page Step 5: Provide a reference prefix. This is added to the transaction reference for every payment processed through the Monnify gateway. For example, MNFY_ Step 6: Provide your redirect URL in the “Redirect URL” field. This is the URL on your server that Monnify redirects customers to after they complete payment on the checkout page. For example, your order confirmation or payment success page. Step 7: Click the “Save Changes” button to save your credentials. Save Monnify credentials Step 8: Click the “Test connection” button to test the gateway connection.
This will automatically redirect you to the Monnify checkout page, and real funds will be processed, typically a small amount (e.g. ₦100), if you are in live mode.
Step 9: Complete the test payment. Once successful, you will be redirected to the redirect URL you provided in Step 6. Step 10: Navigate back to the Archefusion dashboard and click the “Add to my provider” button to add Monnify to your gateway list. Step 11: Toggle the gateway status to “active” to start routing payments through Monnify. Step 12: Copy the webhook URL displayed in the “Webhook URL” field and paste it into your Monnify dashboard under “Developer” > “Webhooks URLs.” This allows Monnify to send payment event notifications to Archefusion on your behalf. Monnify webhook URL

​
How to configure the Korapay gateway

Step 1: Log in to your merchant account and navigate to “Payment Gateways” > “Gateway Providers” > “All Gateways.” Step 2: Scroll through the list and select “Korapay.” Step 3: Click the “Credentials” option and select the “Test” tab.
Only select the “Live” tab when you are ready to process real payments.
Step 4: Select your preferred checkout channels to process payments on Korapay. Available options are: Card, bank transfer, pay with bank, and mobile money. Step 5: Select your preferred default checkout channel, i.e., the checkout channel to automatically redirect the customer to. However, the customer can decide to change it on the checkout page. Available options are: Card, bank transfer, pay with bank, and mobile money. Step 6: Get your public key and secret key from your Korapay dashboard, then paste them in the “Public Key” and “Secret Key” fields, respectively. Korapay credentials page Step 7: Provide your redirect URL in the “Redirect URL” field. This is the URL on your server that Korapay redirects customers to after they complete payment on the checkout page. For example, your order confirmation or payment success page. Step 8: Provide a reference prefix. This is added to the transaction reference for every payment processed through the Korapay gateway. For example, UBR_KORA1 Step 9: Toggle the “Merchant Bears Cost” button to set who should bear the transaction fee.
If toggled on, the merchant bears the transaction fee; otherwise, the customer bears the fee. By default, it is set to true.
Step 10: Click “Save Changes” to save your credentials. SaveKorapay credentials Step 11: Click the “Test connection” button to test the gateway connection.
This will automatically redirect you to the Korapay checkout page, and real funds will be processed, typically a small amount (e.g. ₦100), if you are in live mode.
Step 12: Complete the test payment. Once successful, you will be redirected to the redirect URL you provided in Step 7. Step 13: Navigate back to the Archefusion dashboard and click the “Add to my provider” button to add Korapay to your gateway list. Step 14: Toggle the gateway status to “active” to start routing payments through Korapay. Step 15: Copy the webhook URL displayed in the “Webhook URL” field and paste it into your Korapay dashboard under “Settings” > “API Keys & Webhooks” > “Webhook URL.” This allows Korapay to send payment event notifications to Archefusion on your behalf. Korapay webook url

​
How to configure the Payaza gateway

Step 1: Log in to your merchant account and navigate to “Payment Gateways” > “Gateway Providers” > “All Gateways.” Step 2: Scroll through the list and select “Payaza.” Step 3: Click the “Credentials” option and select the “Test” tab.
Only select the “Live” tab when you are ready to process real payments.
Step 4: Get your public key and secret key from your Payaza dashboard, then paste them into the “Public Key” and “Secret Key” fields, respectively. Payaza API credentials Step 5: Provide a reference prefix. This is added to the transaction reference for every payment processed through the Payaza gateway.
The default is PYZ
Step 6: Provide your redirect URL in the “Redirect URL” field. This is the URL on your server that Payaza redirects customers to after they complete payment on the checkout page. For example, your order confirmation or payment success page. Step 7: Click the “Save Changes” button to save your credentials. Save Payaza credentials Step 8: Click the “Test connection” button to test the gateway connection
This will automatically redirect you to the Payaza checkout page, and real funds will be processed, typically a small amount (e.g., ₦100), if you are in live mode.
Step 9: Complete the test payment. Once successful, you will be redirected to the redirect URL you provided in Step 6. Step 10: Navigate back to the Archefusion dashboard and click the “Add to my provider” button to add Payaza to your gateway list. Step 11: Toggle the gateway status to “active” to start routing payments through Payaza. Step 12: Copy the webhook URL displayed in the “Webhook URL” field and paste it into your Payaza dashboard under “Settings” > “Developers” > “Webhooks.” This allows Payaza to send payment event notifications to Archefusion on your behalf. Payaza webhook url

​
How to configure the Paystack gateway

Step 1: Log in to your merchant account and navigate to “Payment Gateways” > “Gateway Providers” > “All Gateways.” Step 2: Scroll through the list and select “Paystack.” Step 3: Click the “Credentials” option and select the “Test” tab.
Only select the “Live” tab when you are ready to process real payments.
Step 4: Get your public and secret keys from your Paystack dashboard and paste them into the “Public Key” and “Secret Key” fields. Paystack credentials Step 5: Provide a reference prefix. This is added to the transaction reference for every payment processed through the Paystack gateway. For example, Psk_ Step 6: Provide your redirect URL in the “Redirect URL” field. This is the URL on your server that Paystack redirects customers to after they complete payment on the checkout page. For example, your order confirmation or payment success page. Step 7: Click “Save Changes” to save your credentials. Save Paystack credentials Step 8: Click the “Test connection” button to to test the gateway connection.
This will automatically redirect you to the Paystack checkout page, and real funds will be processed, typically a small amount (e.g. ₦100), if you are in live mode.
Step 9: Complete the test payment. Once successful, you will be redirected to the redirect URL you provided in Step 6. Step 10: Navigate back to the Archefusion dashboard and click the “Add to my provider” button to add Paystack to your gateway list. Step 11: Toggle the gateway status to “active” to start routing payments through Paystack. Step 12: Copy the webhook URL displayed in the “Webhook URL” field and paste it into your Paystack dashboard under “Settings” > “API Keys & Webhooks” > “Webhook URL.” This allows Paystack to send payment event notifications to Archefusion on your behalf. Paystack webhook url

​
Test mode vs. live mode

Archefusion offers both test mode and live mode for payment gateway connections. Use the test mode environment to understand the gateway connection process and initiate and complete test payments without moving real funds. When you are ready to accept real payments, provide your valid live API credentials, activate the gateway, and toggle the mode switch from Test to Live on the gateway configuration page. See the Go live page

Next Step

Set your smart routing rules to define which gateway handles which payment, the order in which gateways should be attempted if one is unavailable, and how Archefusion should handle unresponsive gateways during routing.