Archefusion allows you to connect multiple payment gateways through a single integration. Once configured, you can route transactions across your connected gateways without managing each one separately.
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.
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.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.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.
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.
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.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.
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.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.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.
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.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_KORA1Step 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.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.
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.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.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.
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.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.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.
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.
