Adyen
Adyen can be integrated with PHPTRAVELS to accept secure online payments directly from the booking checkout process. This guide explains how to configure your Adyen API credentials in PHPTRAVELS, tes
Overview
The PHPTRAVELS Adyen integration allows customers to complete payments through the Adyen payment platform after creating a booking.
The general process is:
Create or access your Adyen developer account.
Generate or copy your Adyen API key.
Obtain your Adyen Merchant Account name.
Add the credentials inside the PHPTRAVELS Admin Panel.
Test the API connection.
Enable the required payment methods.
Create a test booking.
Complete a test payment.
Verify the payment and booking status.
Move from test credentials to production credentials when ready.
Requirements
Before configuring Adyen with PHPTRAVELS, make sure you have:
An active PHPTRAVELS installation
Access to the PHPTRAVELS Admin Panel
An Adyen developer/test account
Adyen API credentials
An Adyen Merchant Account
At least one payment method enabled in Adyen
A supported currency configured for your Adyen account
Important
Always complete the integration using Adyen test credentials before switching to production.
Step 1: Log in to Adyen
Sign in to your Adyen developer account.
After logging in, you will be taken to the Adyen dashboard.
From the dashboard, navigate to:
Developers → API Credentials
You should see the API credentials associated with your Adyen account.
Step 2: Open Your API Credential
Inside API Credentials, select the appropriate Web Service API credential.
The credential is normally associated with your Adyen company or merchant configuration.
Open the credential to view its available API settings.
Step 3: Generate or Copy the API Key
Inside the API credential settings, locate the API Key section.
Adyen may already have an API key available for the credential. If required, you can generate a new API key.
Copy the API key.
Security Warning
Your Adyen API key is sensitive information. Do not publish it, include it in screenshots, share it publicly, or expose it inside frontend code.
Step 4: Find Your Merchant Account
You will also need your Adyen Merchant Account name.
Copy the Merchant Account exactly as it appears inside your Adyen dashboard.
You will enter this value together with the API key in PHPTRAVELS.
Step 5: Open Payment Gateway Settings in PHPTRAVELS
Log in to your PHPTRAVELS Admin Panel.
Navigate to:
Settings → Payment Gateways
Find Adyen in the available payment gateways and click Edit.
Step 6: Configure Adyen Credentials
Enter the required Adyen information.
API Key
Paste the API key generated from your Adyen developer account.
Merchant Account
Enter your Adyen Merchant Account name.
Webhook
The integration includes webhook configuration support.
If you are initially testing the gateway, complete the main API configuration first. Webhook configuration can be completed according to your production requirements.
Live Prefix
The Live Prefix is mainly required when using the Adyen production environment.
For initial test mode configuration, this field can remain empty unless your setup specifically requires it.
Step 7: Activate the Gateway
Make sure that the Adyen payment gateway is set to Active inside PHPTRAVELS.
If the gateway is disabled, it will not appear during the customer payment process.
Save your gateway configuration after entering the required credentials.
Step 8: Test the Adyen Credentials
PHPTRAVELS includes a credential testing option for the Adyen integration.
Click:
Test Credentials
The system will attempt to communicate with Adyen using the API information you entered.
If the connection is successful, PHPTRAVELS will display the available payment methods supported by your current Adyen configuration.
For example, the system may return several available payment methods for a configured currency such as USD.
Tip
If the credential test fails, verify the API key, Merchant Account name, environment, and gateway activation status before continuing.
Step 9: Enable Payment Methods in Adyen
Adyen supports multiple payment methods depending on your account, country, currency, and merchant configuration.
Make sure at least one payment method is enabled.
For testing, a standard card payment method can be used.
Depending on your Adyen configuration, other payment options may also become available.
Testing the Payment Flow
Once the Adyen gateway has been successfully configured, you can test the complete checkout process from the PHPTRAVELS frontend.
Step 10: Create a Test Booking
Open your PHPTRAVELS website.
For example, select:
Hotels → Choose Destination → Select Hotel → Select Room
Continue to the booking page.
Enter the required customer and booking information.
Select or accept the required booking terms and continue.
Click:
Confirm Booking
The booking will now be created.
Step 11: Check the Initial Booking Status
Before payment is completed, the booking may show a payment status such as:
Payment Status: Unpaid
The booking remains awaiting payment until the Adyen transaction is completed successfully.
Step 12: Proceed to Payment
From the booking details page, click:
Make Payment
Then continue with:
Proceed to Payment
The PHPTRAVELS payment page will open.
Step 13: Select Adyen
Choose Adyen as the payment gateway.
The payment options available on the page depend on the payment methods enabled inside your Adyen account.
For this tutorial, the payment is completed using a test credit card.
Step 14: Enter Test Card Details
Use an Adyen-supported test card while working in the test environment.
Enter the required card information, including:
Card number
Expiry date
CVC/CVV
Any other information required by the selected payment method
Important
Never use real card information while operating in the Adyen test environment.
After entering the test card details, click:
Proceed to Payment
Step 15: Complete the Payment
Adyen will process the test transaction.
If the payment is successful, a successful payment response will be returned.
PHPTRAVELS will then automatically return the customer to the booking confirmation flow.
Step 16: Verify the Booking
After the successful Adyen payment, verify the booking details.
You should see the relevant statuses updated, such as:
Booking Status: Confirmed
Payment Status: Paid
This confirms that the Adyen payment has been successfully processed and connected to the PHPTRAVELS booking.
Step 17: Verify the Transaction
You can also verify the payment from the transaction or payment records available in PHPTRAVELS.
The successful transaction should appear with the associated booking information.
You can additionally verify the transaction from your Adyen dashboard.
Moving from Test Mode to Live Mode
The initial integration should always be completed using Adyen test credentials.
Once you have successfully tested:
API connectivity
Payment methods
Customer checkout
Successful transactions
Booking confirmation
Payment status updates
you can proceed with your Adyen production account.
Contact or complete the required onboarding process with Adyen to obtain access to your live payment environment.
You will then need to update PHPTRAVELS with the relevant production credentials.
This may include:
Production API Key
Production Merchant Account
Live Prefix
Production webhook configuration
Live payment methods
Warning
Do not switch your production website to live Adyen payments until the complete test flow has been verified successfully.
Recommended Production Checklist
Before accepting real customer payments, verify the following:
Adyen production account is approved
Production API credentials are configured
Correct Merchant Account is entered
Adyen gateway is active
Required currencies are supported
Required payment methods are enabled
Live Prefix is configured where required
Webhook configuration is completed
A complete payment test has been performed
Successful payments update bookings correctly
Failed or cancelled payment scenarios have been tested
Transactions can be verified from both PHPTRAVELS and Adyen
Troubleshooting
Adyen Does Not Appear on the Payment Page
Check that the Adyen gateway is enabled inside:
Admin Panel → Settings → Payment Gateways
The gateway must be active.
Also confirm that valid credentials have been saved.
No Payment Methods Are Available
Verify that payment methods have been activated inside your Adyen account.
Payment method availability can depend on:
Merchant configuration
Country
Currency
Adyen account status
Payment method activation
Run Test Credentials again after updating your Adyen configuration.
API Credential Test Fails
Verify:
API key
Merchant Account
Test/live environment
Gateway status
Adyen API credential permissions
Make sure there are no additional spaces when copying the API key or Merchant Account.
Payment Remains Unpaid
If the transaction appears successful in Adyen but the booking remains unpaid in PHPTRAVELS, check:
Adyen transaction status
PHPTRAVELS payment logs
Webhook configuration
API credentials
Merchant Account
Payment environment
For production integrations, webhook configuration is particularly important for reliable payment status synchronization.
Test Payment Is Declined
Make sure you are using valid Adyen test payment details supported by the Adyen test environment.
Do not use live payment cards with test credentials.
Security Recommendations
Never expose your Adyen API credentials publicly.
We recommend:
Keeping API keys private
Never including real API keys in screenshots or videos
Using separate test and production credentials
Limiting credential access to authorized administrators
Configuring production webhooks securely
Rotating credentials if they are accidentally exposed
Integration Flow
The complete Adyen and PHPTRAVELS payment flow is:
Customer creates booking → Booking generated → Customer selects Adyen → Adyen payment page → Payment processed → Successful response → PHPTRAVELS booking updated → Payment marked as paid → Booking confirmed
Video Tutorial
For a complete visual walkthrough, watch our Adyen Payment Gateway integration tutorial.
Video Title: Adyen Payment Gateway Integration with PHPTRAVELS | Complete Setup Tutorial
Video Description: Learn how to configure and use the Adyen Payment Gateway with PHPTRAVELS. This tutorial covers API credential configuration, Merchant Account setup, payment gateway activation, test transactions, checkout processing, successful payment verification, and the complete booking payment workflow.
GitBook Embed
Paste your YouTube video embed directly in this section.
Need Help?
If you experience any issues while configuring Adyen with PHPTRAVELS, please contact the PHPTRAVELS support team through your support ticket.
Our team can assist with the PHPTRAVELS side of the payment gateway configuration and integration.
Last updated