Set up your premium payment platform
Premium payment platforms integrated with Avantio allow you to automate charges related to your bookings and process transactions securely.
The connection process varies depending on the provider. In some cases, you’ll need to create an account and complete onboarding directly with the platform. In others, you’ll need to request certain credentials or connection links from the Avantio Customer Experience team.
In this article, you’ll find the integration process for each provider, the required information, and estimated activation times.
What will you learn in this article?
In this article, you’ll learn how to:
Prepare the necessary information before starting a connection.
Complete onboarding with the payment provider.
Request the required links or identifiers from Avantio.
Provide integration credentials correctly.
Verify the connection with a test booking.
Identify the main errors during the process.
Benefits
Connecting a premium payment platform will allow you to:
Automate charges related to bookings.
Reduce manual intervention by your team.
Centralize payment configuration.
Enhance security with systems like 3D Secure.
Improve transaction traceability.
Easily track charges, refunds, and issues.
Adapt the payment solution to the country where your company operates.
When should you do this setup?
You should complete this setup when:
You’ve chosen the payment platform your company will use.
You’ve confirmed the provider operates in your country.
You want to start processing booking payments through the new platform.
You need to replace a previously used payment gateway.
You want to automate payments you’re currently handling manually.
The provider has approved your company’s account.
Before you start
It’s a good idea to check the following beforehand:
That the selected platform is available in your country.
That you’ve signed up for the service directly with the provider.
That the account is registered under the correct company name.
That you’ve completed all required legal and banking verifications.
That you have administrative access to the account.
That you have all necessary data and credentials ready.
That you know which company, offices, or accommodations will use the connection.
That the person responsible for the setup has sufficient permissions in Avantio.
It’s also recommended to decide internally who will be responsible for reviewing charges, refunds, reconciliations, and any potential issues.
Never send sensitive credentials through unauthorized channels. When you need to provide information to Avantio, do so via a ticket addressed to the Customer Experience team.
Connect your chosen premium platform with Avantio
Comercia Global Payments
Comercia Global Payments
Before you start
To use Comercia Global Payments, you must first start the sign-up and onboarding process directly with Comercia.
Follow these steps
Contact Comercia Global Payments through your commercial contact.
Let them know you want to use Comercia Global Payments with Avantio.
Provide the requested company and banking documentation.
Complete the onboarding process with Comercia.
Wait for Comercia to validate and approve your account.
Comercia will contact Avantio to provide the necessary integration data.
Confirm with the Avantio Customer Experience team that your request is in progress.
Once the connection is available, make a test booking.
Check that the transaction appears correctly in both Avantio and the Comercia interface.
Activation time
The process is usually completed in about a week, although the timeframe may vary depending on the documentation and validations required during onboarding.
Stripe
Stripe
Before you start
To connect Stripe, you’ll need:
A Standard Stripe account.
To have completed the verification process required by Stripe.
Access to the account with sufficient permissions.
A connection link provided by Avantio.
Follow these steps
Go to the Stripe website and create a Standard account.
Complete the requested company, tax, and banking information.
Finish the account verification process.
Create a ticket for the Avantio Customer Experience team.
In the ticket, state that you want to connect your Standard Stripe account.
Wait to receive the connection link.
Open the link and log in with the relevant Stripe account.
Authorize the connection between Stripe and Avantio.
Confirm with the Customer Experience team that the process is complete.
Make a test booking and check that the payment is processed correctly.
Activation time
The connection can be active the same day, as long as your Standard Stripe account is verified and ready to use.
SysPay
SysPay
Before you start
To start the connection with SysPay, you’ll need to complete their onboarding process.
During this process, SysPay will request two identifiers that Avantio must provide:
Account ID.
Merchant ID.
Follow these steps
Contact the SysPay sales team.
Let them know you want to use their integration with Avantio.
Provide SysPay with the required company and banking documentation.
Create a ticket for the Avantio Customer Experience team.
Request your Account ID and Merchant ID for the SysPay connection.
Provide these two identifiers to SysPay.
Complete any pending verifications with the provider.
Wait for SysPay to activate the payment processing module via API.
Once SysPay confirms the module is ready, inform the Avantio Customer Experience team via the ticket.
Avantio will complete the integration setup.
Make a test booking.
Check that the transaction is processed and appears correctly on both platforms.
Activation time
Activation usually takes a few days, depending on how long it takes to complete onboarding and activate the API payment module.
Mercado Pago
Mercado Pago
Before you start
To connect Mercado Pago, you’ll need:
An active company account.
Access to the integrations section.
The account’s User ID.
The secret key set up for webhooks.
The production Access Token.
The webhook URL provided by Avantio.
Follow these steps
Log in to your Mercado Pago company account.
Go to the Your business section.
Select Integrations.
Find the connected applications panel.
Go to the application you’ll use for the Avantio connection.
Find the User ID field.
Copy the value and save it somewhere safe.
Create a ticket for the Avantio Customer Experience team.
Request the URL you need to set up the webhooks.
Return to Mercado Pago and go to the Webhooks section.
Enter the URL provided by Avantio.
In the events section, select Payments.
Find the Secret Key field.
Copy the value for the webhooks secret key.
Go to Production Credentials.
Find the Access Token field.
Copy the value and keep it safe.
Make sure you have the following information:
User ID.
Webhooks Secret Key.
Access Token.
Provide this information to the Avantio Customer Experience team via the ticket and the indicated secure channel.
Wait for Avantio to enter the credentials in the connection assistant.
Once the setup is complete, make a test booking.
Check that the payment is processed and recorded correctly.
Activation time
Activation can be immediate once Avantio receives the correct credentials and completes the setup.
After activation, you’ll need to make a test booking to verify that payments are working correctly.
Tilopay
Tilopay
Before you start
To connect Tilopay, you first need to complete their onboarding process and obtain your production credentials.
The required information is:
Tilopay Key.
Tilopay Password.
Tilopay Proxy Key.
Tilopay User.
You will also need to choose the operation mode you want to use.
Available operation modes
3DS v.2
With this mode, the guest will need to authorize each payment related to the booking using 3D Secure.
This is a good option if you want every charge to require individual authentication by the cardholder.
E-commerce: CIT and MIT
With this mode, the guest authorizes the first payment using 3D Secure.
Subsequent payments related to the booking can be processed automatically as merchant-initiated transactions, as long as the provider's requirements are met.
This is suitable for bookings with multiple due dates or split payments.
Follow these steps
Contact Tilopay directly to start the onboarding process.
Let them know you will be using the integration with Avantio.
Provide the required company and banking documentation.
Complete the verifications requested by Tilopay.
Confirm with Tilopay which operation mode best suits your company: 3DS v.2 or E-commerce with CIT and MIT.
Request your production credentials.
Make sure you have the Tilopay Key, Tilopay Password, Tilopay Proxy Key, and Tilopay User.
Create a ticket for the Avantio Customer Experience team.
Send the required credentials through the secure channel indicated by the team.
Specify the selected operation mode.
Wait for Avantio to set up the integration.
Make a test booking.
Check the first charge and, if applicable, the processing of subsequent payments.
Activation time
Activation is usually completed within a few days, depending on how long it takes to finish onboarding and obtain your credentials.
Ascent Payment Solutions
Ascent Payment Solutions
Before you start
To connect Ascent Payment Solutions, you need to complete their onboarding process and have the following credentials:
Client ID.
Site ID.
Key.
Password.
Price ID.
Follow these steps
Contact Ascent Payment Solutions directly.
Let them know you want to use the integration with Avantio.
Complete the contracting and onboarding process.
Provide the required company and banking documentation.
Wait for Ascent to approve your account and generate your credentials.
Make sure you have the Client ID, Site ID, Key, Password, and Price ID.
Create a ticket for the Avantio Customer Experience team.
Send the credentials through the secure channel provided.
Wait for Avantio to complete the setup.
Make a test booking.
Check that the charge appears correctly in both Avantio and the Ascent interface.
Activation time
The connection is usually completed within a few days, depending on how quickly the onboarding process with Ascent progresses.
Expected outcome
Once you complete the process for your provider:
The payment platform will be connected to Avantio.
You will be able to process charges related to bookings.
Transactions will be sent to the configured platform.
You can review transactions from Avantio and, if applicable, from the provider's dashboard.
Payments will use the security and authentication measures available on the platform.
The integration should only be considered complete after you have successfully made and verified a test booking.
Recommended next steps
After activating the connection:
Make a test booking with a small amount.
Check that the payment is correctly recorded in Avantio.
Make sure the transaction appears in the payment platform.
Verify the payment status and the currency used.
Check that 3D Secure is working properly.
Verify subsequent payments if you use split charges.
Make a test refund if your provider allows it.
Confirm which team members have access to the payment dashboard.
Document your internal procedure for handling incidents and chargebacks.
Let your team know before you start processing real bookings.
Main data and credentials
Depending on the provider, you may need the following:
Stripe: Standard account and connection link.
Comercia Global Payments: Approved account and data managed directly between Comercia and Avantio.
Tilopay: Tilopay Key, Tilopay Password, Tilopay Proxy Key, and Tilopay User.
Ascent Payment Solutions: Client ID, Site ID, Key, Password, and Price ID.
SysPay: Account ID and Merchant ID.
Mercado Pago: User ID, Webhooks Secret Key, and Access Token.
Always treat these credentials as confidential information.
Limitations and considerations
Please note:
Avantio cannot complete the integration until the provider has approved your account.
Activation timelines are estimates.
The required documentation depends on the provider and the country.
Credentials must be for the production environment unless otherwise specified.
An incomplete, expired, or incorrectly copied credential can prevent the connection.
The integration may require involvement from both the provider and Avantio.
Some operations must be managed from the external platform dashboard.
Technical activation does not guarantee that all payment methods are enabled.
3D Secure settings may vary depending on the platform and operation mode.
Subsequent charges may require specific configuration.
You should not start processing real payments without completing a test first.
Before changing a platform that is already in use, check the impact on existing bookings and any pending charges.
Best practices
Use a business account, not a personal account.
Complete onboarding before requesting activation in Avantio.
Carefully check each credential before sending it.
Do not share passwords or tokens through unauthorized channels.
Keep the administrative contact for the platform up to date.
Limit access to only those who really need to manage payments.
Enable two-step authentication in the provider's dashboard when available.
Always make a test booking.
Check both the first payment and any subsequent payments.
Regularly review declined transactions.
Document your internal refund and chargeback process.
Notify Avantio and the provider if you change your bank account, legal entity, or credentials.
Avoid replacing an active connection during periods with a high volume of pending charges.
Practical example
A company decides to use Tilopay to manage bookings with multiple payments.
The company completes onboarding and chooses the E-commerce mode with CIT and MIT, since they want the guest to authorize the first payment with 3D Secure and have subsequent charges processed automatically.
After receiving the production credentials, the company provides Avantio with the Tilopay Key, Tilopay Password, Tilopay Proxy Key, and Tilopay User.
Avantio completes the setup and the company creates a test booking with two due dates. First, they verify the authentication of the initial payment, and then check that the second charge is processed as agreed.
Only after validating both payments do they start using the integration for real bookings.
Common Errors
The connection cannot be activated
Check that the account is fully approved by the provider and that you have completed all pending verifications.
The credentials are not valid
Make sure you have copied the full values, with no extra spaces, line breaks, or missing characters.
Also confirm that these are production credentials and not from a test environment.
The payment does not appear on the platform
Check that the booking uses the correct platform and that the transaction was actually sent.
Also review the payment status and any possible error messages.
3D Secure is not displayed
Authentication may depend on the card type, country, issuer, and platform configuration.
Confirm with the provider that 3D Secure is active on the account.
Subsequent payments are not processed
Check that the platform and operating mode allow for subsequent charges.
In Tilopay, check if E-commerce mode with CIT and MIT has been set up when necessary.
Mercado Pago is not receiving notifications
Check that:
The webhook URL is correct.
The Payments event is selected.
The secret key is valid.
Production credentials are active.
SysPay does not complete activation
Confirm that SysPay has received the correct Account ID and Merchant ID.
When SysPay activates the API module, notify Avantio so we can complete the integration.
If something isn't working
If the integration isn't working as expected, check these points before contacting the Customer Experience team:
Make sure the account is approved and active.
Verify that there are no pending validations with the provider.
Check that the credentials are correct and complete.
Confirm you are using production credentials.
Check that the provider has activated the integration or API module.
Make sure the correct platform is linked to the payment configuration.
Check the transaction status in Avantio and in the provider's dashboard.
Refresh the page and check the result again.
Make a new test booking if needed.
If the issue persists, create a ticket and include:
Company name.
Payment platform used.
Approximate date and time of the operation.
Booking identifier.
Amount and currency.
Payment status.
Full error message.
Screenshots.
Confirmation that onboarding is complete.
Do not include passwords, full tokens, or other sensitive credentials in your screenshots.
Frequently Asked Questions
Do I need to sign up for the platform before connecting it with Avantio?
Do I need to sign up for the platform before connecting it with Avantio?
Yes. You must create or sign up for the account directly with the provider and complete the required onboarding and verification process.
Avantio handles the technical connection, but does not replace the contract between your company and the payment platform.
How long does activation take?
How long does activation take?
The timeframe depends on each provider:
Stripe can be activated the same day if the Standard account is already set up.
Comercia Global Payments may take about a week.
Tilopay, Ascent, and SysPay usually take several days.
Mercado Pago can be activated immediately after receiving and setting up the correct credentials.
These timeframes are approximate and may vary.
Can I send credentials by email?
Can I send credentials by email?
Always use the secure channel indicated by the Customer Experience team.
Do not share passwords, tokens, or sensitive keys through unauthorized channels.
Is it mandatory to make a test booking?
Is it mandatory to make a test booking?
Yes, it is highly recommended.
A test booking allows you to check that the platform is connected, the payment is recorded correctly, and authentication works before processing real bookings.
Who sets up the connection?
Who sets up the connection?
It depends on the platform.
In some cases, Avantio provides a link or sets up the credentials. In others, the provider must first activate a module or contact Avantio directly.
Can I switch payment platforms?
Can I switch payment platforms?
Yes, but you should first review any pending charges and existing bookings.
Do not deactivate the previous platform until you have checked how payments that have not yet been processed will be handled.
What should I do if I change a credential?
What should I do if I change a credential?
Contact the Avantio Customer Experience team to update the configuration.
A modified or revoked credential can interrupt payment processing.
Can I use multiple platforms at the same time?
Can I use multiple platforms at the same time?
The availability of this option will depend on your account configuration, your company structure, and intended use.
Contact the Customer Experience team so we can review your case.