[WooCommerce] Checkout.com
Required for this integration:
- A working version of WooCommerce and Checkout.com on your WordPress instance
- The Checkout.com Payment Gateway Plugin by Checkout.com
- Completed the Checkout.com Configuration & Testing Steps for WooCommerce
Supported Features:
- API Key Integration
- The same API Key Integration will be used with WooCommerce and Autoship Cloud Settings
- Credit Card Payments
- Saved Cards
- Authorize and Capture
- Authorize Only (Optional for Recurring Autoship Orders)
- Save New Credit Cards in My Account
Unsupported Features:
The following features of the Checkout.com Payment Gateway Plugin have not been tested to work with Autoship Cloud
- Google Pay: this feature is not currently supported
- Apple Pay: this feature is not currently supported
- Alternative Payments: this feature is not currently supported
Setting up Checkout.com Payments with Autoship Cloud
In the following steps, we will cover the steps to ensure that Autoship Cloud powered by QPilot is set up to work seamlessly with Checkout.com and WooCommerce.
Step 1: 'Enable Save Cards' for Checkout.com in WooCommerce
In your WordPress Admin, visit the "Core Settings" page of the Checkout.com WooCommerce Payment Method ( WP-Admin > WooCommerce > Settings >> Payments (tab) >>> Core Settings ) and ensure that option to "Enable Save Cards" is set to "Yes".
Pro-Tip: If you are just now setting "Enable Save Cards" to "Yes", we suggest testing your checkout (as a customer) after enabling this option. Test your checkout as a customer by using the Test Card Numbers from Checkout.com in order to ensure that you are able to use this setting successfully before moving forward.
How to know if cards are being saved in Checkout.com
After completing a checkout on your WooCommerce online store, log in to your Checkout.com Hub and navigate to Dashboard > Customers.
Select the customer that was supposed to have saved their card and then scroll to the "Associated Cards" section.
If a card was saved, you should find the card's information there. This information is "tokenized" meaning that a secure value is shown instead of the actual credit card number entered during checkout.
Step 2: Add Checkout.com as a Payment Integration to Autoship Cloud
In your WordPress Admin, navigate to the "Payment Integrations" page of the Autoship Cloud menu ( found in WP-Admin > Autoship Cloud >> Payment Integrations ).
Select the "Add" button and then select "Checkout.com" from the "Payment Method Type" dropdown menu.
Step 3: Add Your API Keys from Checkout.com to Autoship Cloud
In your Checkout.com Hub, navigate to Dashboard > Settings > Channels and locate the Channel (the same Channel that you integrated with your WooCommerce online store).
Then copy + paste the values for your Secret Key and Public Key in your Checkout.com Hub to your Autoship Cloud Settings for Checkout.com ( found in WP-Admin > Autoship Cloud > Settings >> Payment Integrations (tab) )
Pro-Tip: These should be the exact same API Keys you used when setting up Checkout.com with WooCommerce, so you can also copy them right from your WooCommerce settings ( WP-Admin > WooCommerce > Settings >> Payments (tab) >>> Checkout.com >>>> Core Settings (tab) )
Step 4: Test Checkout.com Payments with Autoship Cloud in Test Mode
Before using a new payment gateway in Live Mode, it is necessary to use the following steps to ensure that everything is working as expected in Test Mode (sometimes referred to as "Sandbox Mode").
- Visit your store as a customer (make sure you are no longer logged in as a WordPress Admin).
- Add at least one product scheduled for Autoship to your cart.
- As a customer, complete the checkout using the Checkout.com payment method, using one of the Test Card Numbers from Checkout.com.
Autoship Checkout: When a customer completes a checkout with at least 1 product scheduled for Autoship, this is known as an "Autoship Checkout" because it will result in a Scheduled Order being created based on the schedule(s) that were added to product(s) at checkout. - Verify that the checkout was successfully completed and created a new order in WooCommerce.
- As the same customer, visit My Account > Scheduled Orders, verify that your Schedule Order was created, and that the schedule items and frequency are correct.
- Log back into the WordPress Admin, navigate to WP-Admin > Autoship Cloud > Scheduled Orders, and verify that the newly created Scheduled Order for that customer is present in your list of Scheduled Orders.
Going Live
Once you have successfully completed an Autoship Checkout and verified that a Scheduled Order was created and the payment method was saved, you are ready to enter Live Mode (in which actual charges will be created).
- First, ensure that you are using "Live" settings and not "Test" or "Sandbox" settings from your Checkout.com Hub in WooCommerce.
- Navigate to WP-Admin > WooCommerce > Settings >> Payments (tab) >>> Core Settings (tab) and change the "Environment" option from "SandBox" to "Live".
Ensure the API credentials from your Live (or "Production") Checkout.com Hub are entered in the "Secret Key" and "Public Key" fields. - Select "Save changes" to confirm your changes.
- Navigate to WP-Admin > WooCommerce > Settings >> Payments (tab) >>> Core Settings (tab) and change the "Environment" option from "SandBox" to "Live".
- Next, ensure you are using "Live" settings from your Checkout.com Hub in Autoship Cloud
- Navigate to WP-Admin > Autoship Cloud > Payment Integrations. Select the "edit" button (pencil icon) at the right end of the record for your Checkout.com integration and disable the option for "Test Mode".
Ensure the API credentials from your Live (or "Production") Checkout.com Hub are entered in the "Publishable key" and "Secret key" fields - Select "Update" to confirm your changes.
- Navigate to WP-Admin > Autoship Cloud > Payment Integrations. Select the "edit" button (pencil icon) at the right end of the record for your Checkout.com integration and disable the option for "Test Mode".