How to Integrate APG with bSecure?

How to Integrate APG with bSecure?

Alfalah

Video Guide

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.

What are the charges for this Integration?

Bank Alfalah charges its merchants on a per transaction basis.

If you have a corporate bank account in Bank Alfalah, the MDR (merchant discount rate) charged will be 2.25%

If your corporate bank account is not in Bank Alfafah, the MDR charged will be 3%

How can I integrate APG?

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

Step 2: Test Sandbox Environment

Step 3: Generate Live Credentials - Very Critical Step

Step 4: Enter Live Credentials in bSecure Partner Portal

Step 5: Start Accepting Prepayments

Step 1: Open an Alfa Corporate Account or Instant Merchant Account

image
image
  • 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 the "I agree to the Terms of use and Privacy Policy" checkbox.
  • Click Signup
image
image

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 the Alfa account click here

image
image
image
image

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

image
image

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

image

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.

image

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

image
image

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

image
image

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

image
image
image

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.

image

Once your account is approved, we can move ahead

Step 2: Sandbox Mode testing

image

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:

https://api.bsecure.pk/v1/bank-alfalah-apg-payment-response

Listener URL:

https://api.bsecure.pk/v1/bank-alfalah-apg-payment-notification

image

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

image
image

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

image
  • 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.
image

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 3: 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.
image
  • 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.

Return URL: https://api.bsecure.pk/v1/bank-alfalah-apg-payment-response

Enter Listener URL: https://api.bsecure.pk/v1/bank-alfalah-apg-payment-notification

image

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

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

image

Step 4: Entering the credentials in the bSecure Builder Portal

  1. Once these credentials are generated, Click on the Settings from the main menu.
  2. Then click on the Merchant Credentials in the Business portal.
image
  1. In the Merchant Credentials, select the Payment gateway to APG i.e. Alfalah Payment Gateway.
  2. Then set the Environment to Live.
  3. After going Live, you need to enter the Alfa Portal Credentials that can be seen below.
image
image
  1. These credentials will be saved in the admin portal, with a view-only option in the partner portal.

Step 5: 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