Plan Availability: ✓ Soho | ✓ Pro | ✓ Plus | ✓ Enterprise | X Flex |
- Manage > Ecommerce Setup > Payment
- Manage > Integrations > Payments
Prerequisites: Admin permissions to manage Payment Providers.
About PesoPayBack to top
PesoPay is a leading online Payment Provider in the Philippines, enabling merchants to accept online payments securely via credit cards. With the ability to perform in-app refunds, PesoPay is a great option for sellers in the Philippines.
Setup in CheckfrontBack to top
In order to set up PesoPay in Checkfront, you need to already have an active PesoPay account. If you don't, then visit the PesoPay website to get started.
Once you have an account, it's time to activate the provider within your Checkfront Booking Manager.
To activate PesoPay, navigate to Payment tab (Manage > Ecommerce Setup > Payment) in Checkfront.
Within the Payment tab, locate the PesoPay tile and select it to open the Setup modal.
Enter your Merchant ID and Secret Hash Key.
- Merchant IDBack to top
This can be found at the top of your PesoPay account dashboard when you log in through their website.
- Secret Hash KeyBack to top
PesoPay does not enable the Secure Hash and provide you with the Secure Secret Hash Key by default when you register. You must contact PesoPay support to enable Secure Hash.
After it is enabled, you see the Secure Secret Hash Key in your merchant account's Payment Information section.
This is an additional password you can use to encrypt payment information from Checkfront to PesoPay, but it is not required. To view your secret hash key, navigate to the Payment Information (Profile Payment Information) section in your PesoPay account dashboard. You are able to copy and paste the key from there.
- PesoPay Login ID and PasswordBack to top
Your PesoPay Login ID and Password are required only if you wish to perform refunds within Checkfront. These credentials were provided to you when your account was created.
Finally, click Activate to turn on the modal and PesoPay is live! Make sure you follow the steps below to complete the connection.
Setup in PesoPayBack to top
Now that setup is complete in Checkfront, you need to configure it in PesoPay before you start taking payments.
In your Checkfront account, navigate to the Ecommerce Payment page (Manage > Ecommerce Setup > Payment) and select the PesoPay tile to open the Setup modal.
At the top of the Setup modal, there is a unique URL for your account. Select this URL and copy it.
Now, log into your PesoPay account and navigate to the Profile tab.
Select Payment Options.
In the Return Value Link (Datafeed) field, paste the copied URL from the Checkfront modal. Then, click Save to save these changes.
Next to the Return Value (Datafeed) option, make sure the Enabled option is selected.
You can press the Test button to make sure the URL is working properly. If you get an "SSL Certificate provider" error, try replacing https:// with http:// in the copied URL. This URL lets PesoPay let Checkfront know if a payment was processed successfully or not.If you're still getting this error, or another error, please check that you copied the URL without spaces. If the error persists, reach out to support.
Now, scroll to the bottom of the page and click on Update.
You are asked to confirm your changes. Please review that all of the changes are correct and then click Confirm.
Congratulations! You are now ready to use PesoPay!
Processing RefundsBack to top
Currently, Refunds are not working in PesoPay. Refunds need to be processed in the PesoPay dashboard manually. You can then add a POS refund and a note on the booking in Checkfront for your records. If you have any further questions, then please reach out to support.
In order to process refunds through PesoPay, directly through your Checkfront Booking Manager, you must input your PesoPay Login ID and Password during the activation process we looked at earlier.
If you do this, then refunding an invoice in Checkfront automatically sends that refund back to the customer's credit card via PesoPay.
If you don't use this feature, then you need to manually refund the payment in your PesoPay account dashboard and record a POS refund in Checkfront to balance out your books.
Sandbox (Test Mode)Back to top
We highly recommend running an end-to-end test on your booking system before processing any live payments.
Check the box labelled Sandbox (test mode) in the Payment Provider's activation modal to turn on the test mode.
Don't forget to uncheck this once you are ready to process live credit card payments!