Introduction
This guide details the process of setting up the SimplePay online payment service and integrating it with the system. The purpose of the integration is for the partner to have its own SimplePay account, so payments made by patients are received directly by the partner. This enables independent management of transactions and refunds through the provider's interface.
Following this process is essential to ensure smooth credit card payment functionality. Using your own account guarantees financial transparency and fast settlement.
Main Content
1. Registration and Contracting
The first step to using online payments is to create your own SimplePay account and conclude a service contract. If you already have a SimplePay contract, skip to Section 2.
Visit the SimplePay Partner Portal: https://portal.simplepay.hu/register
Start the registration by providing company details and uploading the required documents.
Follow the steps of the online contracting process. A detailed guide for registration can be downloaded from the provider's website.
2. Creating an Online Merchant Account
After the contract is successfully concluded, the online merchant account must be created through which the system will initiate payments.
Use only the specified aggregator link to create the new merchant account: https://portal.simplepay.hu/register?aggr=medio
Enter the institution's own website address or the booking URL in the URL field.
Providing IPN URL: Copy and paste the following address: https://backend.mymedio.hu/api/v1/payment/init-callback
3. Mandatory Technical Settings
For all system functions to work—especially credit card registration—the following settings must be completed when creating the merchant account:
Two-step payment: Enable.
Credit card registration (Recurring): Enable.
4. Verifying and Delivering Technical Keys
After finalizing the merchant account, the correctness of the data must be verified in the SimplePay Backoffice under the "Technical Data" tab.
IMPORTANT: Online payment in the system does not work with the SimplePay sandbox (test) environment.
Verify that the IPN URL, two-step payment, and credit card registration are correctly configured.
Copy the Merchant ID and Secret Key values.
Send this data through a secure channel to your system contact person.
5. Activation and Testing
Following the delivery of the keys, the system team will record the merchant account and perform a test transaction. Experts will coordinate the go-live date with the institution.
Tips
Tip: Always use the aggregator link for registration, as this ensures technical compatibility with the system.
Tip: Double-check the technical settings (Two-step payment, Recurring), as these can only be modified later by SimplePay customer service upon special request.
Summary
A personal SimplePay account and contract are required to start.
The merchant account must be created via the special aggregator link.
Enabling two-step payment and credit card registration is mandatory.
The Merchant ID and Secret Key must be sent for activation.
FAQ
What should I do if I did not enable credit card registration during creation?
What should I do if I did not enable credit card registration during creation?
In this case, the credit card registration payment method will not be available in the system. To fix this, you must contact SimplePay customer service at [email protected] and request the retrospective enablement of the "Credit Card Registration (Recurring)" function by providing your Merchant ID.
When are the paid amounts transferred to the institution?
When are the paid amounts transferred to the institution?
Since the institution uses its own SimplePay account, the amounts paid by patients arrive directly at the institution; the system does not handle the movement of money.
Who can I contact if I get stuck during registration?
Who can I contact if I get stuck during registration?
For assistance with registration, contracting, and SimplePay interface settings, SimplePay customer service can help. Regarding the delivery of keys and activation, please contact your system contact person.