To configure 2Checkout payment gateway follow these steps:
Sandbox mode no longer works with our extension, so 2Checkout payments will have to be tested with real payments.
First, install the extension just like any other plugin.
Once installed, go to Downloads → Settings → Payment Gateways.
You will have the option to enable one or both of the 2Checkout gateways:
Purchases made with 2Checkout will send customers to the 2Checkout website where they will complete the purchase.
Purchases made with 2Checkout Onsite will keep customers on your website and allow them to enter their credit / debit card details on the checkout screen. Note: this option requires that you have an SSL certificate installed on your website.
After you have chosen which gateway options you want to use, enter your 2Checkout account information:
Note: The 2Checkout Account Number is labeled as the Merchant Code in 2Checkout’s settings and the Secret Word is the Secret Key in the API 2Checkout settings. This wording will be fixed in the next 2Checkout release.
From your 2Checkout account, account information is located under Integrations / Webhooks & API. The Publishable and Private API is only needed for onsite purchases with credit/debit cards.
If INS is not properly configured, purchase processing will not work.
2Checkout’s Instant Notification Service allows 2Checkout to communicate with your store, keeping transaction data in sync. INS must be set up properly for purchase processing and recurring billing to work.
From your 2Checkout account, navigate to the Integrations / Webhooks & API screen and enable all notifications (INS & Global INS). The URL should be set to:
Replace “example.com” with the appropriate name of your website.
If you find that your INS requests are failing, make sure you’re using the same protocol for all requests. For example, if you make your request via HTTP, but then require HTTPS for incoming requests (from 2Checkout for example) then they’ll fail, since they don’t match.
This notice can happen when the billing address is not filled out. The billing address is required, so hiding or removing it will cause the transaction to fail.
If you receive this error, it means one of two things:
1. Your 2Checkout account has not been fully approved. Contact 2Checkout’s support team to confirm and to fully activate your account.
2. Not all required fields are being sent to 2Checkout. This could happen if you have removed the billing address or other required fields on the checkout form. To resolve the problem, restore the fields that were removed.
No. If you have a custom setup on a subscription, 2Checkout does not currently allow them to update their credit card information. Additional information is available on the 2Checkout website.
Recurring Payments integrates fully with 2Checkout. The 2Checkout payment gateway is available for Easy Digital Downloads via the 2Checkout extension. Documentation for installing, configuring, and using that extension is here.
Important! If INS is not properly configured, renewal payments will not work.
INS should have been configured when following 2Checkout Payment Gateway Setup Instructions.
When using 2Checkout, a cancellation may be initiated either from within EDD or from the 2Checkout Dashboard.
Due to limitations of the 2Checkout API, cancellation options inside the EDD admin interface will only be available if you place a special username and password inside of your wp-config.php file.
1. Create an API user role
2. Create a new user in your 2Checkout account and give them API access.
Click the View users -> Add user after creating the roleORFrom the 2Checkout Dashboard, click your username at to top right then go to Settings → Manage user access → Add User.
Fill out the required information for the API User. Make sure the following items are properly configured:
3. Add the username and password of the newly created user to your wp-config.php file:
define( 'TWOCHECKOUT_ADMIN_USER', 'USER NAME HERE' );
define( 'TWOCHECKOUT_ADMIN_PASSWORD', 'PASSWORD HERE' );
Go to Downloads → Subscriptions and click View on the item you want to cancel.
Then in the bottom of the next screen click on Cancel Subscription.
When you set a subscription to canceled, it’s canceled immediately, but the customer will still have access to their purchased material for as much time as they’ve paid for.
Example: Your customer paid $10/mo, and you cancel halfway through the month. They still have access to their material for the rest of the month, but they won’t be re-billed, and access will stop at the end of the month.
Note: EDD will always stop “After a specified number of billing cycles”, therefore it doesn’t matter if choose to stop automatic billing Now or After a specified number of billing cycles.
Click to see the 2Checkout documentation for details
It doesn’t matter if you cancel a subscription in EDD or in 2Checkout, the effect is exactly the same and the customer won’t notice a difference.
When using the 2Checkout payment gateway, refunds are processed the same way as any other transaction.
Additionally, refunds may be processed from within the 2Checkout admin also.
Note: In 2018 2Checkout updated its user interface, so it’s possible some settings were changed/moved when the update occurred. If anything is not working as expected, review all settings in this document and 2Checkout Payment Gateway Setup Instructions. If you had an account prior to the new interface, it’s likely some settings need to be updated to work properly.
Example of PHP error: PHP Fatal error: Uncaught Twocheckout_Error: : Invalid Username/Password thrown in /var/www/html/wp-content/plugins/edd-2checkout/sdk/lib/Twocheckout/Api/TwocheckoutUtil.php
If you are seeing a PHP error related to Invalid Username/Password, it’s related to the API User. Confirm the API User’s Password lifetime setting is set to “Never expire”, then update the password. Update your wp-config.php file with the new password.
To fix, confirm the API’s user role is properly set to “API read/write” and confirm “API read only” is deselected, as detailed in the documentation above.
First, review the subscription details in EDD, the Profile ID should not start with 2Checkout and it should match the 2Checkout subscription ID. If they do not match, update the Profile ID with the correct Subscription ID. Otherwise, review all documentation to confirm 2Checkout is properly configured. If the Profile ID is incorrect for a couple of transitions, there may have been a temporary communication issue. If most or all subscriptions have the wrong Profile ID, first confirm that 2Checkout is properly configured per the instructions above, specifically INS. If everything is properly configured, reach out to support so we can further investigate.
Powered by BetterDocs