Starting with Safepay: A step-by-step guide

Ready to start accepting online payments? Read this guide to understand the steps you need to follow to get to that point. 

Who should read this document? Anyone who wants to start using Safepay. We’ve created this step-by-step guide to provide users of Safepay with a process flow to get them up and running as quickly as possible. 

We go into a lot of detail in this document. If you want to learn more about a certain area please skip to the part of the document which is relevant for you.

Step 1: Setting up your Sandbox Account

Step 2: Moving from a Sandbox Account to a Production Account

Terms used in this document

If you have further questions which are not answered here, please email us at support@getsafepay.com.

Step 1: Setting up your Sandbox Account

A Sandbox Account allows a user to get familiar with Safepay so that when their application is processed and approved, they can switch to live mode (i.e. their Production Account) with zero downtime.

Sign up to Sandbox

Please visit our Sandbox website to set up your Sandbox Account. This website is different from our Production website (which you will need to use to create your Production Account later).

Please provide the following information:

  • Email address: You can sign up with any email address and password. Normally this would be something like admin@<storename>.com or finance@<storename>.com, but there are no restrictions. Your email address must be valid and you must have access to it as we will send an automated email to that email for verification. If you have not received an email from Safepay after signing up please click here.
  • Password: A secure password to authenticate you to the dashboard.
  • Phone number: Please make sure your phone number is no longer than 10 digits.
  • Business name: Please provide your business’s name. 
  • Business website: If you've entered a URL, please make sure it has either http or https written before it.

Important to note

If you want to use Safepay Checkout on different websites, you must create a separate account with Safepay for each website.

Even if you have been approved for a Safepay Account for one website, for regulatory reasons we need to treat an application to use Safepay on any other website as a separate application. You will have to submit a KYC application in association with any other website in order to be approved for a separate Safepay Account.

Your Safepay Dashboard will not provide you consolidated information across all websites your have integrated it.

Create a Webhook Secret Key for your Sandbox

Your Webhook Secret Key is used to sign all transactions to ensure that each payment is unique and valid. Please note that you will need to also enable this for your Production Account when this is created. 

The Webhook Secret Key for your Sandbox Account is called your  Sandbox Secret API key. The Webhook Secret Key for your Production Account is called your Production Secret API key. 

From your Safepay Dashboard navigate to  Account>Developer as shown below.

Create your Webhook Secret Key by clicking on Create.

What next in Sandbox? 

You should now have access to your Sandbox Account. A Sandbox Account looks and works exactly the same way as a Production Account except that the money shown in the account isn’t real and test card numbers can be used to simulate payments (click here for sample dummy data to conduct transactions with). 

Creating a Sandbox Account allows our users to learn how our different products work. There will be a big blue banner on your dashboard after you log-in saying that you are in a Sandbox environment. 

You can use your Sandbox Account to:

  • View and manage your Sandbox Account.
  • Become familiar with our features by:
    • Integrating Safepay Checkout on your website by choosing the relevant plug-in. You can configure any of our plug-ins with your website through your Sandbox API key and Secret key. You can use our plug-in to test out how the checkout flow works on your website. Make sure you are able to see orders being generated in your system as well as reconcile them with the payment on the Sandbox dashboard. Read this guide to learn about other features in our merchant dashboard.
      • You can access detailed instructions for integrating our WooCommerce plug-in here.
      • You can access detailed instructions for integrating our Shopify plug-in here.
      • You can access detailed instructions for integrating our WHMCS plug-in source code here. For easy installation, you can install our WHMCS plug-in from Marketplace here.
      • You can access detailed instructions for integrating our other plug-ins (Magento 1.9, Magento 2.0 and Opencart) here.
      • You can access instructions for custom code here.
    • Using Quick Links to generate one link invoices. If you are using Quick Links only, you do not need to install our plug-ins on your website. Read this guide to learn more about Quick Links.
    • Using Connect to accept payments. Read this guide to learn more about Connect.
    • Observe payment details that you receive from test buyers.
  • See notifications generated by your mock transactions.
  • Learn how to add bank accounts: Read this guide to learn more about setting up your bank accounts. You can input your real bank account information in your Sandbox Account, but we advise creating a test account as you will have to add your real bank account details to your Production Account to accept transfers.  
  • Learn how to make transfer requests: Read this guide to learn more about making transfer requests.

Important to note

Any transaction made while you are in Sandbox mode will not be real. Even if a customer manages to make a payment to your through your website while you are integrating a plug-in, this will not be a real transaction. No real money will have left your customer and you will not have received any real money. 

If a customer has somehow paid you while you are still in Sandbox mode, their payment actually hasn’t been made as this is not possible. You should refund your customer's payment from your Sandbox dashboard in any event. Read this guide to learn how to make a refund.

To avoid mistakenly accepting payments through your Sandbox integration, you can create a demo or testing subdomain for testing (this option is available on WooCommerce) instead of your live website. This way there is no risk that a customer visits your website and makes a payment using Safepay. 

Step 2: Moving from your Sandbox Account to a Production Account

After creating your Sandbox Account and becoming familiar with it, set up your Production Account by visiting our Production website

Sign up to Production

Sign up to create an account in the same way you did for your Sandbox Account. You can either use the same details that you used for signing up to your Sandbox Account or completely different details. 

Important to note

Your Production Account is a separate account from your Sandbox Account so you will need to provide details as if you are signing up to Safepay again. Refer to the instructions earlier in this document as to what information you need to fill out.

What happens next in Production? 

  • When you log-in to your Production Account, you will see a red notification on top of the dashboard asking you to CONTACT SUPPORT in order to start accepting live payments.

  • Send an email to support@getsafepay.com asking us to enable your account. We will reply back to you with a short KYC form you have to fill out. We collect this information to comply with requirements from regulators and financial partners. All fields are required and all attachments should be readable. Read this guide to understand what we ask for as part of our KYC policies. 
  • If you have integrated any plug-in with your website through your Sandbox Account, you do not need to repeat this. You will only have to replace your Sandbox keys with your Production keys in your administration panel. 
  • Enable the Webhook Secret Key for your Production Account. Click here to see how to do this. 
  • Send us your Production API Key by email to support@getsafepay.com. Without this we cannot activate your account.
  • While we review your application you can do the following:
    • Set up your bank accounts to which you can transfer payments you have received through Safepay. Read this guide to learn about setting up your bank accounts. 
    • Set up your notifications and customize your store branding and logo. Read this guide to learn how to set up your email addresses and customize your store.
    • Remember to enter your Production API key in the right field of your plugin settings. Also please enable the Webhook Secret Key of your Production Account. Without doing this you will remain in Sandbox Mode.

When will Safepay contact me?

We receive many applications every day from merchants across Pakistan. We aim to respond to all queries within 48 hours but sometimes it can take longer than this. If the provided information is verified, we will contact you either with a request to collect more information or with an email letting you know that your account has been successfully enabled to accept live payments.

Welcome to Safepay!

Terms used in this document

  • Sandbox Account Our Sandbox Account is simply a demo account. Any transactions conducted through your Sandbox Account are not real. The reason why we provide a Sandbox Account is to provide you with an extensive, secure-test environment where you can test your technical integration with Safepay.  
  • Production Account : This is a live account through which you can conduct real transactions. 
  • Sandbox keys: Your Sandbox Account is configured with two API keys. Your Sandbox API key is your public key that can be shared and displayed. You can find this under Account>Settings from your Safepay dashboard in your Sandbox Account. Your Sandbox Secret API key is your private key and should never be shared. You can find this under Account>Developers from your Safepay dashboard in your Sandbox Account.
  • Production keys: Your Production Account is configured with two API keys. Your Production API key is your public key that can be shared and displayed. You can find this under Account>Settings from your Safepay dashboard in your Production Account. Your Production Secret API key is your private key and should never be shared. You can find this under Account>Developers from your Safepay dashboard in your Production Account.
Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us