How to Integrate APG with bSecure?

How to Integrate APG with bSecure?

What is APG Integration?

APG stands for Alfa Payment Gateway. Through this integration, a Builder can start accepting prepayments on their websites.

How can I integrate APG?

Step 1: Open an Alfa Corporate Account or Instant Merchant Account and get yourself verified.

Step 2: Ensure you are a bSecure Verified Builder. Go to Builder verification or read here to get your bSecure partner account verified.

Step 3: Test Sandbox Environment

Step 4: Generate Live Credentials - Very Critical Step

Step 5: Enter Live Credentials in bSecure Partner Portal

Step 6: Start Accepting Prepayments

  • Enter your email address. This will be used as your registered email address and all inquiries and OTPs etc will be shared on this email.
  • Enter a Username of your choice. You can also select to use your email address as your user name by clicking the checkbox
  • Enter your mobile number. This number will be registered with the bank and used for all correspondence and OTPs.
  • Lastly, set a password.
  • After Reading the Terms and Privacy Policy, please click on I agree to the Terms of use and Privacy Policy checkbox.
  • Click Signup

Next, you will be asked to select your Business Type and Account category. Business Type is partnerships, sole proprietorship, public limited company, private limited company. Select whichever applies. Account categories are Instant Account or Merchant Account. To read more about Alfa account click here


Next you will be sent an OTP on your registered email address and phone numbers. Enter the OTPs below and verify yourself


You’ve made it to the Alfa Portal. Congratulations!


Once you have arrived at the portal you will be requested to complete these steps to verify an account.

Moving forward keep the following items handy.

1. NIC front and back pictures 2. Your passport size picture

Fill in your business details in this section. It is important that you fill in all the details.


Next Fill in all the details pertaining to yourself or the primary account holder.


Next, upload your legal documents which include clear scanned images of the front and back of your NIC or NICOP and your passport size photograph


After submitting the above details, Read the Terms and Conditions and click Accept to proceed with your account creation.


Your account will be sent for verification. You will receive an email confirmation also.

You can log in to check if your account is approved by the Bank.

Verification usually takes 48-72 hours.


Once your account is approved, we can move ahead

Step 2: bSecure Builder Verification

Step 3: Sandbox Mode testing


Now select your store from the drop down and enter the following credentials in the Return and Listener URLs and click on generate credentials.

Return URL:

Listener URL:


Merchant Hash Key and username and password will be auto-generated.


Now on the left side menu, click on Integration and Page Redirection.

  • On the lower end of the page, there will be a grey shaded box.
  • All relevant keys for the sandbox environment are there.
  • Make sure you copy the keys leaving out the commas from the sides
  • Do not use these keys to generate any LIVE credentials.

Get on a call with bSecure Administrator through Live chat. The administrator will enter these in the bSecure Admin portal.

Once sandbox testing is complete, move to the next step.

Step 4: Generate Live Credentials - Very critical Step

  • To generate live credentials, log in to your Alfa portal and get on a call with us through live chat. This is a very critical step and we would recommend staying on a live call with one of our customer service representatives.
  • Once you are live with us, move forward.
  • You will be requested to submit a Return URL and Listener URL. Copy the URLs from below and paste them. Recheck the URLs and be very sure that they are pasted correctly because once you press generate credentials, the URLs will be locked and can’t be edited.
  • In case of a mistake in copying the URLs, your account will be disabled and it will take 72 hours to get your account live again.

Click on the Generate Credentials button to generate the live credentials which include

1. Merchant Hash Key 2. Merchant Username 3. Merchant Password


Step 5: Entering the credentials in bSecure Partner Portal

  • Once these credentials are generated, you are requested to get on a call with the bSecure Administrator through intercom
  • You will be asked for these credentials to enter in bSecure Admin portal.
  • These credentials will be saved in the admin portal, with a view-only option in the partner portal.

Step 6: Start accepting prepayment orders:

  • After entering these credentials, BAF credit card, Wallet, and Bank Transfer gateways will be active and you can start accepting prepayment orders.
  • Now place a test order and try out all these gateways