WooCommerce Payments provides your store with: Show
WooCommerce Payments is currently available only to merchants based in a supported country and selling in a supported currency. Requirements ↑ Back to top
Installation ↑ Back to topTo install WooCommerce Payments:
To learn more about installing plugins from a Zip file, see Installing and Managing Plugins. Get Started ↑ Back to topNOTE: If you are setting up WooCommerce Payments for someone else, it’s best to have them complete the account creation process for themselves. This is because it’s not always possible to change the account information once it’s been saved, especially if the site accepts live transactions before the correct account information is entered. Please see our documentation on Dev Mode for instructions on how to test WooCommerce Payments correctly. After installing the plugin, to begin using WooCommerce Payments, you need to:
To complete the verification process, go to Payments and click Set Up. During this process, you will be asked for some basic information about yourself and your business. You will also be asked to add a bank account or a debit card in order to receive payouts. Adding a bank account is preferred two reasons:
Once you have completed the verification with Stripe, your site will be ready to accept credit and debit card payments onsite. Step 1 – Payments Welcome ScreenStep 2 – Connect to WordPress.comStep 3 – Verify detailsStep 4 – Set up completeManage transactions ↑ Back to topMany different types of transactions can occur with your store via WooCommerce Payments, including:
With WooCommerce Payments, you can view and manage each of these different types of transactions within your WordPress dashboard. Deposits ↑ Back to topDeposits occur when a portion of your account balance is paid to your nominated bank account or debit card. Deposits are scheduled to transfer automatically to your deposit account. Eligible merchants can also request an instant deposit. WooCommerce Payments provides a list view and detail view of these deposits. To access deposits, go to Payments > Deposits. On this page, you can:
If your account balance ever becomes negative, then a Withdrawal transaction type may be displayed on this screen. Withdrawals represent a debit from your bank account to cover the negative balance. Example Payments > Deposits administration screenTransactions ↑ Back to topWooCommerce Payments provides a list view to access the information about all transactions on your site. This page includes transactions including the capture of a charge, payment, payment failure refund, refund, refund failure, dispute, and dispute reversal. To access the transactions list view, go to Payments > Transactions. On this page, you can:
If the payment is only authorized and not charged, those transactions will not show on this page. You can either manually capture the charge or in the case of an expired authorization, the customer will get the refund in the form of a reversal. For further details get in touch with a Happiness Engineer via the WooCommerce.com Support page. Downloading TransactionsOn the transactions screen, you can download your transactions via the download button. If all of your transactions are visible in the list view (maximum of 100), your export file will download immediately. Otherwise, an export file will be emailed to you. This is sent to the email address on your WordPress.com account. This may be different from you WooCommerce.com email address, your site’s admin user email address, the email address on your account with the site, and the email address on the WooCommerce Payments account. Note: there are minor differences between immediate and emailed exports. For example, the emailed export will not contain order IDs, but will contain transaction IDs. Disputes ↑ Back to topA dispute is a chargeback or inquiry from a card issuer about a charge. Disputes occur when your customer questions a transaction with their card issuer. You can view and respond to a dispute, and potentially overturn it, from within WooCommerce Payments. To view the disputes, go to Payments > Disputes. On this page, you can:
Learn more about challenging disputes, and evidence required to overturn different types of disputes, in the dispute response guide. Example Payments > Disputes administration screenRefund a payment ↑ Back to topIf a customer contacts you to request a refund, and your refund policy permits it, you can refund the payment from within your WordPress administration dashboard. To refund a payment:
The charge amount plus transaction fees will be deducted from your account balance and returned to the customer’s original payment method. Refund durations ↑ Back to topRefunds are processed immediately, however, depending on the customer’s bank, it can take anywhere from 5 to 10 business days before it reflects on the customer’s statement. In some cases, often when the payment is closely followed by a refund, the refund might be processed as a reversal. In this scenario, the original payment disappears from the customer’s account statement entirely and the balance reflects as though the charge never occurred. If your customer doesn’t see the refund after 10 business days and the original charge is still visible on their bank statement, they should contact their bank for more information. If further difficulties with processing the refund are encountered beyond this timeframe, please contact support. Manually capture an authorized charge ↑ Back to topIf Issue an authorization on checkout, and capture later is enabled in the Transaction preferences, you will need to manually capture charges authorized by customers when they placed their order. NOTE: It’s not possible to capture an amount more than the authorized amount, although you can optionally capture less by first editing the order and then capturing. To manually capture an authorized charge:
Importantly, you need to capture funds manually within 7 days of the order being placed, otherwise the authorization will be canceled alongside the order. Capture charge action on the WooCommerce > Edit Order screenSettings ↑ Back to topTo change your store’s configuration:
Each setting available on this screen is explained in more detail below. General ↑ Back to topEnable WooCommerce PaymentsDisable WooCommerce Payments to stop accepting credit cards on checkout using this payment gateway. You will continue to be able to access the Deposits, Transactions and Disputes administration screens after WooCommerce Payments is disabled. Conversely, having too many payment gateways enabled can overwhelm customers with choice and make your site administration more complex. It’s usually best to enable card purchases via a single gateway only so as to not confuse your visitors during the checkout process. A checkout page with too many options for card payments.Test modeTo test payments or disputes, you need to switch WooCommerce Payments into Test Mode. To view previously processed test transactions, you also need to enable Test Mode. Test mode allows you to simulate transactions using test card numbers. It ensures your checkout is working and enables view-as-customer without placing a real order. Test mode only works with test credit card numbers. Disable test mode to accept payments via real credit cards. Express checkouts ↑ Back to topEnable express checkoutsEnable express checkouts if you would like your customers to checkout via Google Pay, Apple Pay, or Stripe Link. Show express checkouts onThis section controls where express checkouts is available. For example, by checking “Checkout”, “Product page” and “Cart”, shoppers can use express checkout on the checkout page, the product page, and the cart page. Customize appearanceWooCommerce Payments supports a few options for you to customize your express checkout button. Do note, there are two styles of buttons you might see depending on if you a) allow third-party cookies for the site you’re visiting, and b) have the “Share that you have Google Pay with companies outside Google” setting enabled in Google Pay itself. If both a) and b) are true, the button is styled like this: Otherwise, the button is styled like this: Transactions ↑ Back to topTransaction preferencesBy default, payments will be charged at the time of checkout. Enable Issue an authorization on checkout, and capture later if you would prefer to authorize payments on checkout and manually capture the charge later (e.g., on shipment). Importantly, you need to capture funds manually within 7 days of the order being placed, otherwise the authorization will be canceled alongside the order. Customer bank statementCustomer banks statements explain charges or payments on bank statements and include information that banks and card networks require to help customers understand their statements. Familiarize yourself with the requirements and recommendations for statement descriptors. Use this field to set the name of the store to be displayed on the customer’s credit or debit card bank statement. By default the site URL specified during onboarding is used. Deposits ↑ Back to topDeposit scheduleIf you’re eligible, you can change how often you receive WooCommerce Payments deposits into your connected bank account. There are 3 deposit schedule frequency options:
Please keep the following in mind when selecting a deposit schedule:
Click here to learn more about How do I change my deposit schedule with WooCommerce Payments? Bank account informationYour WooCommerce Payments account information is securely stored and managed with our partner, Stripe. Once you have completed account set up, WooCommerce Payments provides a link to access the Stripe dashboard through which you can view and update the following business information:
Advanced settings ↑ Back to topDebug modeIf you are having issues processing payments or viewing dashboard screens, enable the debug log to record information about these events. To enable the debug log, go to Payments > Settings > Advanced settings: Enable WooCommerce Payments Debug modeDebug logs can be found in the WooCommerce > Status > Logs section of your dashboard. To view the logs:
Multi-Currency ↑ Back to topWooCommerce Payments allow merchants to set up their store to receive payments in one of many currencies, giving the shopper a list of currencies to choose from. The functionality is enabled as part of WooCommerce Payments. You should see the Multi-Currency tab after visiting Payments > Settings. To learn about its options and how to configure them for your store, read over the Multi-Currency with WooCommerce Payments guide. Card Readers ↑ Back to topWooCommerce Payments supports In-Person Payments, allowing customers to pay “in-person” via a debit or credit card. Merchants use a card reader to scan the card and issue a receipt. You will find a list of your card readers by navigating to the Payments > Card Readers page. The Card Readers pageReceipt settingsOn each successful transaction, your customer will automatically be emailed a receipt. You will also have the option to issue a printed receipt through the WooCommerce mobile app. Certain details of customer receipts can be customized by switching to the Receipt details tab on the Card Readers page. There you can modify your business, customer support, and branding settings. These settings apply to both email and printed receipts. Receipt details tab on the Card Readers pageUse the Preview a printed receipt link to preview saved settings. Note that this option will only show a preview of the printed receipt, which is different from the email receipt template. You can modify the email template by visiting WooCommerce > Settings > Emails > New receipt. Subscriptions ↑ Back to topUnlike other WooCommerce payment gateways, which require the use of the WooCommerce Subscriptions extension to sell subscriptions, WooCommerce Payments both supports that extension and includes built-in subscription functionality. That means when using WooCommerce Payments, you have a choice between two different ways to sell subscriptions:
To learn more about these options, and which is best for your store, read over the subscription option comparison guide. Transactions Linked to a Subscription ↑ Back to topWhen looking at the Transactions page the subscription number will be listed next to any transactions that are linked to a subscription. Go to Payments > Transactions: Similarly, when opening a particular transaction, the subscription number will be listed next to the order number: Payment Method Changes ↑ Back to topIn order for a store manager to change the payment method linked to a subscription, head to WooCommerce > Subscriptions. Open the specific subscription that needs to be edited, and click on the pencil icon next to Billing: An edit form will open up, where you can select from the customer’s saved payment methods: Once you have selected the new credit card, click on Update to save changes on the subscription. New checkout experience (Early Access) ↑ Back to topIn WooCommerce Payments version How to activate the new checkout experience? ↑ Back to topIf it’s not enabled yet, go to: WP Admin > Payments > Settings. Under Payments accept on checkout section, enable the new checkout experience by clicking Enable in your store button: A new screen will appear where you can select a few additional payment methods available within your WooCommerce Payments account: Payments accepted on checkout ↑ Back to topAfter enabling the “New checkout experience” you can view the available payment methods. To enable or disable payment methods, toggle the corresponding checkboxes and click on “Save changes” at the bottom of the page. How to disable the new checkout experience? ↑ Back to topGo to: WP Admin > Payments > Settings. Under Payments accept on checkout section, click on the three dots, then click Disable: Another screen will pop up asking you to confirm: What if a payment method can’t be enabled? ↑ Back to topBased on your WooCommerce Payment status, a certain payment method may not be available, and you’ll be asked to contact WooCommerce Support to enable the payment method you require. When contacting WooCommerce Support, please make sure to include the payment method name that you want to enable. Translations (Localization) ↑ Back to topWooCommerce Payments comes localization-ready out of the box, with support for the following languages:
Translations are provided by the teams over at translate.wordpress.com. Stable versions and development versions of WooCommerce Payments are translated there, and anyone can contribute. When you install or update WooCommerce Payments, WordPress will look for a translation in your language and automatically download it. Troubleshooting ↑ Back to topError determining the connection status ↑ Back to topIn certain circumstances, like when restoring a site from backup, this error could be encountered under WooCommerce > Settings > Payments > WooCommerce Payments. Should that be the case, the connection to WordPress.com needs to be reset. To reset the connection:
The Jetpack plugin isn’t required to run WooCommerce Payments, however it’s needed in order to reset the connection. Step 1 – Jetpack > DashboardStep 2 – DisconnectStep 3 – Set up to reconnectWooCommerce Payments Safe Mode ↑ Back to topSafe Mode helps to prevent issues in cases where duplicate sites are connected to the same WooCommerce Payments connection. You’ll know your site is in Safe Mode via clear notice. Read more on the WooCommerce Payments Safe Mode page. Error retrieving deposits, Error retrieving deposits overview, Error retrieving disputes. ↑ Back to topThese errors are likely a result of the Jetpack connection. Go to Jetpack > Dashboard, scroll down to the Connection section, and disconnect the site from Jetpack. Once done, reestablish the connection there to resolve the error message. The Jetpack plugin isn’t required to run WooCommerce Payments, however, it’s needed in order to reset the connection. Error Amount must be at least $0.50 ↑ Back to topOur payments partner, Stripe, requires a minimum of goods value of at least $0.50. This minimum amount is to ensure that you don’t lose money on a charge because Stripe’s processing fee combines a small fixed amount and a percentage. To resolve the error, please make sure that your product price is at least $0.50. After I deleted/ restored a subscription product when WooCommerce Payments was inactive, adding the product to cart results this error “There was a problem creating your subscription” ↑ Back to topIf a subscription product is deleted then restored while WooCommerce Payments is disabled, enabling WooCommerce Payments again will result in this error. When deleting and restoring a subscription product, please make sure that WooCommerce Payments is enabled so the subscription product status is in sync with WooCommerce Payments. Further Reading ↑ Back to topTo learn more about WooCommerce Payments, see the FAQs. Learn how to test different transactions in the Testing Guide. |