> For the complete documentation index, see [llms.txt](https://docs.phptravels.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.phptravels.com/payments/adyen.md). # Adyen {% embed url="" %} ### Overview The PHPTRAVELS Adyen integration allows customers to complete payments through the Adyen payment platform after creating a booking. The general process is: 1. Create or access your Adyen developer account. 2. Generate or copy your Adyen API key. 3. Obtain your Adyen Merchant Account name. 4. Add the credentials inside the PHPTRAVELS Admin Panel. 5. Test the API connection. 6. Enable the required payment methods. 7. Create a test booking. 8. Complete a test payment. 9. Verify the payment and booking status. 10. 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.