Managing Money with WooPayments

Spanish version of this pageAquí puedes encontrar la versión en español de esta página

Although WooPayments makes charging your customers as easy as possible, it’s still helpful to be familiar with the various ways in which money can move through your site and your account. This document explains how WooPayments presents information to you about where your money came from and where it’s going.

Overview

↑ Back to top

The Payments > Overview page gives you a brief summary of how money is flowing through your WooPayments account.

The top section shows your account balance. Click the question mark icons to learn more about what each figure means, or consult this document.

If you have added multiple bank accounts in order to receive payouts in different currencies, a dropdown is shown so you can view your balance in each currency.

Occasionally, the top box may change, such as if you have a dispute nearing its deadline or if there’s another time-sensitive action needed for your account. To keep your store and WooPayments account running smoothly, it is recommended that you attend to any tasks that appear here.

Below that, the Payouts section shows a list of your recent payouts and their amounts.

The Account Details section shows your account’s current status. In most cases, payments will show as enabled and payouts will be set to automatic, but if your ability to take payments or receive payouts has been suspended for some reason, that will be shown here.

Finally, the Payments > Overview page will also show a list of messages containing information about your account, tips on using WooPayments, and other such information. Each one can be acted on or dismissed.

Account statuses

↑ Back to top

Your account status provides a quick way to understand the condition of your WooPayments account. The various statuses and their respective meanings are listed below.

  • Complete: Your account is fully verified and in good standing.
  • Enabled: Your account is currently in good standing, but we might require more information from you in the future, usually once you exceed a certain payments volume.
  • Pending Verification: Your account is under review by our team or by our payments partner. No action is required on your part. The status will update when the review is complete.
  • Restricted Soon: Your account is active, but there’s a deadline by which you must provide more information. If you don’t meet the deadline, your account will become Restricted.
  • Restricted: Your ability to take payments and/or receive payouts has disabled until we can collect additional information. You’ll receive an email about the situation.
  • Under Review: Your ability to take payments and/or receive payouts has been disabled until our team can review your account.
  • Rejected: Your account was permanently disabled by us or our payments partner.

Payouts

↑ Back to top

Payouts are when some or all of your account balance is sent to your bank account or debit card. Payouts occur automatically by default, but eligible merchants can also request instant payouts.

WooPayments provides all the relevant information about your payouts under the Payments > Payouts menu. On that page, you can:

  • View a list containing all past payouts.
  • See each payout date, amount, currency, and the account to which it was sent.
  • View which transactions are associated with each given payout.

Each payout has a status associated with it. Here are the common ones and what they mean:

  • Completed (Paid): The payout was successfully sent to your bank account.
  • Completed (Deducted): This is actually a withdrawal due to a negative balance.
  • In Transit: The payout is on the way to your bank, but not there yet.
  • Pending: The payout has been cleared but has not been submitted to the bank.
  • Failed: There was a problem with the payout. It will be retried in 24 hours.

By clicking on any payout, you can open the payout details page, where more information about that particular payout is shown.

Filtering payouts

↑ Back to top

If you wish, you can filter the list of payouts so that it contains only the ones you’re interested in viewing. To do that, follow these steps:

  1. Click the Show dropdown menu at the top of the list.
  2. Click Advanced filters.
  3. Click Add a filter.
  4. Filter the list by Date, Status, or both.
  5. When you’ve added the filters you want, click the Filter button.
Filtering the payouts list.

Downloading payouts

↑ Back to top

You can also download payouts in the form of a CSV file for later use in Microsoft Excel, Google Sheets, Apple’s Numbers, or other spreadsheet editing applications.

To download all your payouts, simply go to Payments > Payouts and click the Download button at the top of the list.

If you have less than about 25 payouts in the list when you click the Download button, the CSV will download immediately.

If you have more than 25 payouts, WooPayments will compile the CSV in the background and email you when it’s done. Additionally, if your site language is not set to English (United States), you will be prompted to select the language of your exported report.

After the CSV is compiled, you will receive an email that will contain a link where you can download the complete CSV in your preferred language.

Bank reference keys

↑ Back to top

A bank reference key is a unique identifier for a payout that banks may provide to help track down missing or delayed payouts. If a reference key is available for a given payout, it’ll be shown in the payouts list.

If you suspect that a payout is missing from your bank account, you can contact your bank and provide the reference key to see if they can help find the funds. It may be best to wait 5 working days before doing this, since internal bank processes may face delays.

Some other things to note about bank reference keys:

  • They are not supported for payout accounts in Japan.
  • They are not supported for payouts that occurred before December 2024.

Transactions

↑ Back to top

WooPayments provides all the relevant information about your transactions under the Payments > Transactions menu. This page includes information such as the date and time of a transaction, the amount, the fees, the order number, and so on.

To access the transactions list view, go to Payments > Transactions.

Viewing the list of transactions under Payments > Transactions.

NOTE: The Transactions page only shows transaction details for orders paid for with WooPayments. It does not show information for orders paid for using other gateways you might have active on your site.

If the payment was authorized but not captured, those will appear under the Uncaptured tab at the top. For further details on that workflow, see our authorize and capture guide.

Viewing a list of uncaptured transactions under Payments > Transactions > Uncaptured.

Each transaction has a type associated with it. Here are the common ones and what they mean:

  • Charge: The customer paid for their order using their credit or debit card.
  • Payment: The customer paid using a non-card method, like Bancontact.
  • Refund: The customer’s money was sent back to their credit or debit card.
  • Payment Refund: The customer’s money was sent back to their non-card method.
  • Dispute: The customer disputed the charge, and the dispute funds were deducted from your account pending the bank’s decision.
  • Dispute reversal: You won the dispute, and the disputed funds were returned to your account.

By clicking on any transaction, you can open the payment details page, where more information about that particular transaction is shown.

Searching transactions

↑ Back to top

If you need to quickly find a specific transaction or set of transactions, you can use the search bar at the top of the list. You can search by order number, customer name, or billing email.

Searching transactions for those from a specific customer name.

Filtering transactions

↑ Back to top

If you wish, you can filter the list of transactions so that it contains only the ones you’re interested in viewing. To do so:

  1. Click the Show dropdown menu at the top of the list.
  2. Click Advanced filters.
  3. Click Add a filter.
  4. Filter the list by Date, Customer Currency, Type, Loan, or a combination of those.
  5. When you’ve added the filters you want, click the Filter button.
Filtering the transactions list to show only transactions from US customers placed after April 5, 2024.

Downloading transactions

↑ Back to top

You can also download transactions in the form of a CSV file for later use in Microsoft Excel, Google Sheets, Apple’s Numbers, or other spreadsheet editing applications.

To download all your transactions, simply go to Payments > Transactions and click the Download button at the top of the list.

Downloading a list of transactions.

If you have less than about 25 transactions in the list when you click the Download button, the CSV will download immediately.

If you have more than 25 payouts, WooPayments will compile the CSV in the background and email you when it’s done. Additionally, if your site language is not set to English (United States), will be prompted to select the language of your exported report.

After the CSV is compiled, you will receive an email that will contain a link where you can download the complete CSV in your preferred language.

Refunding a payment

↑ Back to top

If a customer contacts you to request a refund, and your refund policy permits it, you can refund their payment from your administrator dashboard via either:

  1. Editing an order at WooCommerce > Orders
  2. The transaction details at Payments > Transactions.

Regardless of which method used, the charge amount plus transaction fees will be deducted from your account balance and returned to the customer’s original payment method.

NOTE: In certain cases, you may not be able to issue a refund for an order. Mainly, this happens when there’s a dispute on all or part of the charge, or when your account balance has gone negative for some reason.

Via the edit order page

↑ Back to top

To process a refund via the edit order page:

  1. Go to WooCommerce > Orders.
  2. Search for the order using the customer name, email, or order number.
  3. Click the order to open it.
  4. Scroll down a bit below the items list and click the Refund button.
  1. In the Qty column, adjust the quantity of each item to be refunded.
    • If you want to provide a full refund, ensure that the quantity to be refunded is equal to the quantity that the customer originally purchased, and that any shipping charges are also being refunded (if your policies permit that).
  1. Optionally enter something in the Reason for refund box.
  2. Click the Refund via WooPayments button.

Via the transaction details

↑ Back to top

To process a full refund via the transaction details page:

  1. Go to Payments > Transactions.
  2. Search for the transaction using the customer name, email, or order number.
  3. Click the order to open it.
  4. Select the three dots next to the Payment ID number.
  1. Choose to refund the transaction in full.

NOTE: Refunding via the transaction details currently only supports full refunds. Selecting the Partial refund option will direct you to the edit order page, and you can follow the directions for issuing a refund via the edit order page here.

  1. Optionally identify the reason for the refund.
  2. Select the Refund transaction button to process the refund.

Refund durations

↑ Back to top

Refunds are processed immediately. However, depending on the customer’s bank, it can take anywhere from 5 to 10 business days before they get their money back in their account.

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.

Reversals

↑ Back to top

If a refund is sent shortly after the original charge, the refund might be processed as a “reversal.” What this means is that the original charge will simply disappear from the customer’s statement, and a separate credit is not issued.

Thus, if you refund a customer soon after they ordered, but they never see the amount added back to their statement, you can simply ask them to review their statement for the original charge. It should be gone, as if they never transacted with you at all.

Preventing refund delays

↑ Back to top

In some cases, you may need a sufficient WooPayments account balance in order to process a refund. If your account balance cannot cover the refund, your balance may go negative or the refund may not succeed at all.

To prevent this, you can use the future refunds or disputes (FROD) balance. In brief, it’s a special bucket of funds inside your WooPayments account that will be drawn from first when your account balance is debited for incoming refunds or disputes.

Proactively adding money to your FROD balance can help prevent delays in refunding your customers, leading to a better experience for them and fewer disputes for you.

Failed payments

↑ Back to top

Payment failures (also called “declines”) can happen for a number of reasons. Most often, they occur because the card issuer has declined the charge, or some other system has blocked it. Only rarely do they signify an error with WooPayments.

Payment failures/declines will show different error messages to the customer during checkout, depending on the particular issue or type of decline:

  • Error: Your card was declined.
  • Error: There’s a problem with this payment. Please try again or use a different payment method.
  • Error: Your card has insufficient funds.
  • Error: Your card has expired.
  • etc.

NOTE: When a payment is declined, sometimes the customer will still see that charge appear in their bank’s online interface. This is merely temporary. The declined payment will be removed from their statement within a few days.

Card issuer declines

↑ Back to top

Card issuers (e.g. Visa or Mastercard) have sophisticated data models that analyze a large number of factors and either allow or decline a charge in real-time. Issuer declines happen when these automated systems decide to not allow a charge.

Some of the most common card issuer declines are:

  • Generic declines. This is by far the most common type of decline. Cardholders should contact their bank and work with them in order to resolve the problem.
  • Non-sufficient funds (NSF). If a customer doesn’t have enough funds or credit in their account, the card issuer may decline the transaction.
  • Incorrect card data. If a customer enters an incorrect card number, verification code, or expiration date, the card issuer may decline the transaction.
  • Fraudulent activity. If a card issuer suspects fraudulent activity on the part of the customer (the cardholder), they may decline the transaction.

Should a charge be declined during checkout, WooPayments will show a decline message to the customer on the checkout page itself:

For security and privacy reasons, card issuers only discuss the specifics of a decline with their cardholder. If the decline error message doesn’t contain an explanation of the issue, you should instruct customers to contact their bank about it.

Blocked payments

↑ Back to top

Blocked payments occur when the card issuer has decided to allow the charge, but the charge ends up being rejected by a secondary system later in the process, such as Stripe Radar or WooPayments’ fraud protection settings.

If Stripe Radar blocks a charge, customers will see a generic decline message:

If WooPayments’ fraud protection rules have blocked a transaction, customers will also see a generic error message in order to avoid revealing your specific fraud protection rules. As the merchant, you can see the rule that triggered the block.

Disputes

↑ Back to top

A dispute (also called a “chargeback”) occurs when a card owner questions a payment with their bank. You can learn more about preventing disputes and responding to them at those links. This section is simply an overview of how disputes are shown in WooPayments.

WooPayments provides all the relevant information about your disputes under the Payments > Disputes menu. This page includes information such as the amount that was disputed, the dispute status, and deadline for responding to it.

Viewing the list of disputes under Payments > Disputes.

Each dispute has a status associated with it. Here are the common ones and what they mean:

  • Won: You won this dispute and recovered the money from the charge.
  • Lost: You lost this dispute, the money from the charge, and a dispute fee.
  • Needs Response: You have yet to respond or accept the dispute.
  • Under Review: The dispute is being decided by the customer’s bank.

By clicking on any given dispute, you can open the transaction details page, where more information about that particular dispute is shown.

From here you can challenge the dispute or accept the dispute. Again, please see the guides linked above for a much more thorough review of this process.

Filtering disputes

↑ Back to top

By default, the disputes list shows only those disputes that still require a response. However, you can change this by using the filters at the top.

First, you can use the Dispute Currency filter to show only disputes in the currency of your choosing. Second, you can use the Show filter to see only disputes needing a response, all dispute, or more advanced filters.

Downloading disputes

↑ Back to top

Similar to payouts and transactions above, you can also download your dispute data in the form of a CSV file for later use in Microsoft Excel, Google Sheets, Apple’s Numbers, or some other spreadsheet editing applications.

To download all your transactions, simply go to Payments > Disputes and click the Download button at the top of the list.

Downloading the list of currently displayed disputes.

If you have less than about 25 disputes in the list when you click the Download button, the CSV will download immediately.

If you have more than 25 disputes, WooPayments will compile the CSV in the background and email you when it’s done. Additionally, if your site language is not set to English (United States), will be prompted to select the language of your exported report.

After the CSV is compiled, you will receive an email that will contain a link where you can download the complete CSV in your preferred language.

Use of your personal data
We and our partners process your personal data (such as browsing data, IP Addresses, cookie information, and other unique identifiers) based on your consent and/or our legitimate interest to optimize our website, marketing activities, and your user experience.