{"id":1331,"date":"2025-12-29T09:23:05","date_gmt":"2025-12-29T08:23:05","guid":{"rendered":"https:\/\/quanticalabs.com\/docs\/chauffeur-booking-system\/?post_type=lsvr_kba&#038;p=1331"},"modified":"2025-12-30T16:35:27","modified_gmt":"2025-12-30T15:35:27","slug":"adyen-payment-gateway-configuration","status":"publish","type":"lsvr_kba","link":"https:\/\/quanticalabs.com\/docs\/chauffeur-booking-system\/knowledge-base\/adyen-payment-gateway-configuration\/","title":{"rendered":"Adyen Payment Gateway: Configuration"},"content":{"rendered":"<div class=\"tip\">\n<p><strong>Good to Know<\/strong><\/p>\n<p><a href=\"https:\/\/1.envato.market\/adyen-addon-chauffeur-taxi-booking-system\">Adyen Add-on<\/a> is a separate extension that adds native Adyen payment gateway support to the Chauffeur Taxi Booking System for WordPress plugin. Before configuring the add-on, make sure you have the latest version of the Chauffeur Taxi Booking System installed on your WordPress site.<\/p>\n<\/div>\n<p>The Adyen Add-on allows you to accept online payments processed through the <a href=\"https:\/\/www.adyen.com\" target=\"_blank\" rel=\"noopener\">Adyen<\/a> platform directly in the Chauffeur Taxi Booking System booking form. Configuration consists of two main steps:<\/p>\n<ol>\n<li>Generating required credentials in your Adyen Dashboard.<\/li>\n<li>Entering these values and basic settings in the booking form configuration.<\/li>\n<\/ol>\n<h2>Generating Credentials in Adyen<\/h2>\n<p>To configure Adyen, you need to generate\/copy three values:<\/p>\n<ul>\n<li><strong>API Key<\/strong><\/li>\n<li><strong>HMAC Key<\/strong> (for webhooks verification)<\/li>\n<li><strong>Merchant account<\/strong> (Account code)<\/li>\n<\/ul>\n<div class=\"tip\">\n<p><strong>Good to Know<\/strong><\/p>\n<p>Adyen provides separate environments for <strong>Test<\/strong> and <strong>Live<\/strong>. We recommend starting with the <strong>Test<\/strong> environment to verify the booking flow, then switching to <strong>Live<\/strong> when you are ready to accept real payments.<\/p>\n<\/div>\n<h3>1) Log in to Adyen<\/h3>\n<ol>\n<li>Go to <a href=\"https:\/\/ca-live.adyen.com\/\" target=\"_blank\" rel=\"noopener\">https:\/\/ca-live.adyen.com\/<\/a>.<\/li>\n<li>Select the environment at the top: <mark>&#8216;Live&#8217;<\/mark> or <mark>&#8216;Test&#8217;<\/mark>.<\/li>\n<li>Enter your <strong>username<\/strong>, then select the <strong>account<\/strong> and enter your <strong>password<\/strong>.<\/li>\n<\/ol>\n<p>If you don\u2019t have an Adyen account yet, follow the onboarding steps here: <a href=\"https:\/\/docs.adyen.com\/get-started-with-adyen\" target=\"_blank\" rel=\"noopener\">https:\/\/docs.adyen.com\/get-started-with-adyen<\/a>.<\/p>\n<h3>2) Generate API Key<\/h3>\n<p>To generate the API Key, follow these steps:<\/p>\n<ol>\n<li>In the left menu, go to <mark>&#8216;Developers&#8217;<\/mark> -&gt; <mark>&#8216;API credentials&#8217;<\/mark>.<\/li>\n<li>Click <mark>&#8216;Create new credential&#8217;<\/mark>.<\/li>\n<li>In the popup, keep the default option <mark>&#8216;Web service user&#8217;<\/mark> and click <mark>&#8216;Create credential&#8217;<\/mark>.<\/li>\n<li>On the credential details screen, open <mark>&#8216;Server settings&#8217;<\/mark> -&gt; <mark>&#8216;Authentication&#8217;<\/mark> -&gt; <mark>&#8216;API key&#8217;<\/mark>.<\/li>\n<li>Click <mark>&#8216;Generate API key&#8217;<\/mark> and copy the generated key.<\/li>\n<li>Click <mark>&#8216;Save changes&#8217;<\/mark> to store and enable the newly generated API key.<\/li>\n<\/ol>\n<div class=\"important\">\n<p><strong>Important!<\/strong><\/p>\n<p>Copy and store the API key securely. Depending on your Adyen configuration, you may not be able to display it again later.<\/p>\n<\/div>\n<h3>3) Generate HMAC Key (Webhook)<\/h3>\n<p>To generate the HMAC key for webhook verification, follow these steps:<\/p>\n<ol>\n<li>In the left menu, go to <mark>&#8216;Developers&#8217;<\/mark> -&gt; <mark>&#8216;Webhooks&#8217;<\/mark>.<\/li>\n<li>Click <mark>&#8216;Create new webhook&#8217;<\/mark>.<\/li>\n<li>In the popup, select <mark>&#8216;Standard webhook&#8217;<\/mark> and click <mark>&#8216;Add&#8217;<\/mark>.<\/li>\n<li>In the webhook configuration screen, first open the <mark>&#8216;Server configuration&#8217;<\/mark> section and set the following:\n<ul>\n<li><strong>URL<\/strong> \u2013 enter the URL of the page where the Chauffeur Taxi Booking System plugin is installed. In most cases, this will be your website domain or the exact page URL with the booking form. Example: if the plugin is installed on <mark>https:\/\/yourdomain.com\/test\/chauffeur-booking-system\/<\/mark>, use this URL.<\/li>\n<li><strong>Method<\/strong> \u2013 leave the default value (usually <mark>JSON<\/mark>).<\/li>\n<li><strong>Encryption protocol<\/strong> \u2013 leave the default value (e.g. <mark>TLSv1.3<\/mark>).<\/li>\n<\/ul>\n<\/li>\n<li>Next, open the <mark>&#8216;Security&#8217;<\/mark> section.<\/li>\n<li>In the <mark>&#8216;Authentication method&#8217;<\/mark>, select <mark>&#8216;No authentication&#8217;<\/mark>.<\/li>\n<li>In the <mark>&#8216;HMAC&#8217;<\/mark> section, choose <mark>&#8216;Generate a new key&#8217;<\/mark> and click <mark>&#8216;Generate&#8217;<\/mark>.<\/li>\n<li>Copy the generated <strong>HMAC key<\/strong> and save the webhook configuration.<\/li>\n<\/ol>\n<div class=\"important\">\n<p><strong>Important!<\/strong><\/p>\n<p>The webhook <strong>URL<\/strong> must be publicly accessible and must point to the page where the Chauffeur Taxi Booking System is installed. This endpoint is required for Adyen to send payment status notifications back to your website.<\/p>\n<\/div>\n<h3>4) Copy Merchant account (Account code)<\/h3>\n<p>To find your Merchant account (Account code), follow these steps:<\/p>\n<ol>\n<li>In the left menu, go to <mark>&#8216;Settings&#8217;<\/mark> -&gt; <mark>&#8216;Account&#8217;<\/mark> -&gt; <mark>&#8216;Merchant accounts&#8217;<\/mark>.<\/li>\n<li>Copy the <strong>Account code<\/strong> (your Merchant account value).<\/li>\n<\/ol>\n<h2>Configuring Adyen in the Booking Form<\/h2>\n<p>Once the add-on is installed and activated, you can configure Adyen for each booking form individually.<\/p>\n<ol>\n<li>In your WordPress dashboard, go to <mark>&#8216;Chauffeur Booking System&#8217;<\/mark> -&gt; <mark>&#8216;Booking Forms&#8217;<\/mark>.<\/li>\n<li>Edit the booking form where you want to enable Adyen payments.<\/li>\n<li>Open the <mark>&#8216;Payments&#8217;<\/mark> tab of the form editor.<\/li>\n<li>Go to the sub-tab <mark>&#8216;Payments&#8217;<\/mark> and then click the <mark>&#8216;Adyen&#8217;<\/mark> payment method tab.<\/li>\n<\/ol>\n<p>On the <mark>&#8216;Adyen&#8217;<\/mark> tab you will find the following options:<\/p>\n<h3>Test Mode<\/h3>\n<p>Enable this option if you want to process test transactions using Adyen <strong>Test<\/strong> environment credentials. Disable it when switching to <strong>Live<\/strong>.<\/p>\n<h3>API Key<\/h3>\n<p>Paste here your Adyen <strong>API key<\/strong> generated in the Adyen Dashboard (<mark>&#8216;Developers&#8217;<\/mark> -&gt; <mark>&#8216;API credentials&#8217;<\/mark> -&gt; <mark>&#8216;Server settings&#8217;<\/mark> -&gt; <mark>&#8216;API key&#8217;<\/mark>). This key authorizes the Chauffeur Taxi Booking System to communicate with the Adyen API.<\/p>\n<h3>HMAC Key<\/h3>\n<p>Paste here your Adyen <strong>HMAC key<\/strong> generated in the Adyen Dashboard (<mark>&#8216;Developers&#8217;<\/mark> -&gt; <mark>&#8216;Webhooks&#8217;<\/mark> -&gt; <mark>&#8216;Create new webhook&#8217;<\/mark> -&gt; <mark>&#8216;Standard webhook&#8217;<\/mark> -&gt; <mark>&#8216;Security&#8217;<\/mark> -&gt; <mark>&#8216;HMAC&#8217;<\/mark>). This key is used to verify webhook notifications from Adyen.<\/p>\n<h3>Merchant Account<\/h3>\n<p>Enter your Adyen <strong>Merchant account<\/strong> (Account code) copied from the Adyen Dashboard (<mark>&#8216;Settings&#8217;<\/mark> -&gt; <mark>&#8216;Account&#8217;<\/mark> -&gt; <mark>&#8216;Merchant accounts&#8217;<\/mark>).<\/p>\n<h3>Return URL<\/h3>\n<p>Enter the full URL (including https:\/\/) of the page where customers should be redirected after they are sent back from Adyen. We recommend using a dedicated \u201cThank you\u201d or \u201cOrder summary\u201d page.<\/p>\n<h3>Redirection Delay<\/h3>\n<p>Set the delay (in seconds) before the customer is redirected from the booking form to the Adyen payment gateway.<\/p>\n<h3>Logo<\/h3>\n<p>Optionally, you can upload a custom logo that will be displayed on step #3 of the booking form when the customer selects the Adyen payment method.<\/p>\n<h3>Information for Customer<\/h3>\n<p>Use this field to display additional information to the customer before they are redirected to the Adyen gateway (step #5 of the booking process).<\/p>\n<h2>Enabling Adyen as a Payment Method<\/h2>\n<p>After entering the Adyen settings, you still need to enable this gateway as one of the payment options in the booking form:<\/p>\n<ol>\n<li>While still editing the booking form, go to <mark>&#8216;Payments&#8217;<\/mark> -&gt; <mark>&#8216;General&#8217;<\/mark>.<\/li>\n<li>In the <mark>&#8216;Payment&#8217;<\/mark> option, select <mark>&#8216;Adyen&#8217;<\/mark> as one of the available payment methods for this form.<\/li>\n<li>Optionally, set <mark>&#8216;Adyen&#8217;<\/mark> as the <mark>&#8216;Default Payment&#8217;<\/mark> if you want it to be preselected for customers.<\/li>\n<li>Click <mark>&#8216;Update&#8217;<\/mark> or <mark>&#8216;Publish&#8217;<\/mark> to save your changes.<\/li>\n<\/ol>\n<h2>Debugging and Log Manager<\/h2>\n<p>After installing the add-on, a new settings section will appear in your WordPress dashboard under <mark>&#8216;Settings&#8217;<\/mark> -&gt; <mark>&#8216;Chauffeur Booking System: Adyen&#8217;<\/mark>. This section includes a <strong>Log Manager<\/strong> tool that allows you to verify the correctness of your configuration and review any errors or warnings related to the payment process.<\/p>\n<div class=\"important\">\n<p><strong>Important!<\/strong><\/p>\n<p>Make sure you use matching credentials for your selected mode: <strong>Test<\/strong> credentials for <strong>Test Mode<\/strong>, and <strong>Live<\/strong> credentials when <strong>Test Mode<\/strong> is disabled. Also ensure your Adyen account is fully configured for the currencies and payment methods you want to offer.<\/p>\n<\/div>\n<div class=\"doc-version\">\n<p><strong>Summary<\/strong><\/p>\n<p>Document version: 1.0<br \/>\nLast updated: December 29, 2025<br \/>\nPlugin version: 9.1+<\/p>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>Good to Know Adyen Add-on is a separate extension that adds native Adyen payment gateway support to the Chauffeur Taxi Booking System for WordPress plugin. Before configuring the add-on, make sure you have the latest version of the Chauffeur Taxi Booking System installed on your WordPress site. The Adyen Add-on allows you to accept online [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"footnotes":""},"lsvr_kba_cat":[26],"lsvr_kba_tag":[],"_links":{"self":[{"href":"https:\/\/quanticalabs.com\/docs\/chauffeur-booking-system\/wp-json\/wp\/v2\/lsvr_kba\/1331"}],"collection":[{"href":"https:\/\/quanticalabs.com\/docs\/chauffeur-booking-system\/wp-json\/wp\/v2\/lsvr_kba"}],"about":[{"href":"https:\/\/quanticalabs.com\/docs\/chauffeur-booking-system\/wp-json\/wp\/v2\/types\/lsvr_kba"}],"author":[{"embeddable":true,"href":"https:\/\/quanticalabs.com\/docs\/chauffeur-booking-system\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/quanticalabs.com\/docs\/chauffeur-booking-system\/wp-json\/wp\/v2\/comments?post=1331"}],"version-history":[{"count":10,"href":"https:\/\/quanticalabs.com\/docs\/chauffeur-booking-system\/wp-json\/wp\/v2\/lsvr_kba\/1331\/revisions"}],"predecessor-version":[{"id":1352,"href":"https:\/\/quanticalabs.com\/docs\/chauffeur-booking-system\/wp-json\/wp\/v2\/lsvr_kba\/1331\/revisions\/1352"}],"wp:attachment":[{"href":"https:\/\/quanticalabs.com\/docs\/chauffeur-booking-system\/wp-json\/wp\/v2\/media?parent=1331"}],"wp:term":[{"taxonomy":"lsvr_kba_cat","embeddable":true,"href":"https:\/\/quanticalabs.com\/docs\/chauffeur-booking-system\/wp-json\/wp\/v2\/lsvr_kba_cat?post=1331"},{"taxonomy":"lsvr_kba_tag","embeddable":true,"href":"https:\/\/quanticalabs.com\/docs\/chauffeur-booking-system\/wp-json\/wp\/v2\/lsvr_kba_tag?post=1331"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}