Skip to main content

Refunds

You can issue partial or full refunds on orders, returning funds to the buyer's original payment method. Refunds can be scoped to an entire marketplace order, specific seller orders, or individual line items.

With line item and seller order refunds, you can choose to subtract the refund amount from the seller's next payout. Otherwise, the marketplace bears the cost of the refund.

Similar to handling payments, refunds are managed from the marketplace order. You can issue multiple refunds for the same order, but you must use the same method for all refunds.

Refunded amounts are returned to the buyer in the original transaction currency. For credit card transactions processed through gateways like Stripe, the refund is automatically credited back to the buyer's card.

Permission requirements

Only marketplace operators can process refunds. Marketplace staff must have the "Manage refunds" permission assigned through their permission group to process refunds.

Issue a refund​

There are three methods available when issuing refunds:

  1. Order line refund: Select specific order lines to automatically calculate the refund amount.
  2. Seller order refund: Manually enter a percentage or fixed amount to refund against one or more seller orders.
  3. Marketplace order refund: Manually enter a percentage or fixed amount to refund against the entire marketplace order.

After issuing a partial refund on an order, you can issue subsequent refunds using the same refund method.

info

Mixing different refund methods is not allowed. For example, you cannot refund a percentage of the order and later refund a specific order line.

An order must be at least partially paid for the Refund button to appear. Meaning, payment must be captured against the order.

Refund order lines​

Order line refunds allow you to select one or more order lines within an order. The system automatically calculates the refund, including applicable taxes. Shipping is a separate line item in each seller order that can be included in the refund if desired.

  1. From the dashboard, go to the Orders page.
  2. Open the order for which you want to issue a refund.
  3. Under the Fully paid summary section, select Refund.
  4. On the MP Order - Refund page, select Order line refund as the method to determine the refund total.
  5. Expand each seller order within the order and choose the Quantity of each line item that you want to refund.
  6. To refund shipping, enter the amount to refund in the shipping line under each seller order. Any applicable shipping tax will be automatically calculated and added to the entered amount.
  7. (Optional) Select Deduct from seller payout to charge the refund cost to the next payout for each respective seller.
  8. (Optional) Enter a Reason for refund at the bottom of the page to provide an internal note about the refund. This reason will be displayed on the marketplace order.
  9. Verify that the refund totals under Summary are accurate.
  10. When ready, click Approve to process the refund.

Refund seller orders​

You can choose to refund a percentage of each seller order or a fixed dollar amount on each.

The percentage is calculated against the order total, with taxes, shipping, and all line items taken into account.

  1. From the dashboard, go to the Orders page.
  2. Open the order for which you want to issue a refund.
  3. Under the Fully paid summary section, select Refund.
  4. On the Refund page, select Manual refund as the method to determine the refund total.
  5. Select For one or more sellers.
  6. Select Percentage from the dropdown.
  7. Under Seller Orders, select each order you wish to refund.
  8. Enter the percentage of each seller order to refund.
  9. (Optional) Select Deduct from seller payout to charge the refund cost to the next payout for each respective seller.
  10. (Optional) Enter a Reason for refund at the bottom of the page to provide an internal note about the refund. This reason will be displayed on the marketplace order.
  11. Verify that the refund totals under Summary are accurate.
  12. When ready, click Approve to process the refund.

Refund the entire marketplace order​

You can choose to refund a percentage of the marketplace order or a fixed dollar amount.

note

When refunding the entire marketplace order, you cannot deduct the refund from seller payouts.

The percentage is calculated against the order total, with taxes, shipping, and all line items taken into account.

  1. From the Dashboard, go to the Orders page.
  2. Open the order for which you want to issue a refund.
  3. Under the payment summary section, select Refund.
  4. On the Refund page, select Manual refund as the method to determine the refund total.
  5. Select For the entire order.
  6. Select Percentage from the dropdown.
  7. Enter the percentage of the order to refund.
  8. (Optional) Enter a Reason for refund at the bottom of the page to provide an internal note about the refund. This reason will be displayed on the marketplace order.
  9. Verify that the refund totals under Summary are accurate.
  10. When ready, click Approve to process the refund.

Viewing refunds​

Each refund for an order shows up as a line item in the payment summary on the MP Order details page. Each refund line item includes the following information:

  • Reason for refund
  • Amount refunded
  • Seller payout deduction status

For an explanation of the various refund states and lifecycle, see the developer documentation for Refunds.

Cancel a refund​

After initiating a refund, a refund record in the "Requested" state is generated. This stays on the order page even if you leave the refund page.

Steps​

  1. Go to the order page where a refund was initiated.
  2. Click the refund row to open the MP Order - Refund page.
  3. In the footer bar, select Cancel.

Scenarios​

Review the following sections to learn more about how to handle refunds in various scenarios.

Refund the entire order​

To refund an entire order, whether the marketplace order or seller order, use the Manual refund -> Percentage option and refund 100% of the order. This is the most reliable way to refund the full order total and consider applicable taxes, rather than entering a fixed dollar amount.

Refund shipping​

To refund shipping, you can process an Order line refund and choose to refund only the shipping under one or more seller orders.

Charge a refund to the seller​

The marketplace operator bears the refund cost by default. You can choose to charge a refund to the seller when refunding order lines or seller orders. This option is not available for refunds applied to the entire marketplace order.

To deduct the refund from the seller, check the Deduct from seller payout box. This will reduce the seller's next payout, and the refund will appear on their payout statement.

Refunds and commission

As you process payouts, keep in mind that refunds do not change the marketplace commission calculation. The commission is based on the originally captured payment.

Even if a seller's order is fully refunded and deducted from their payout, the marketplace's commission will not change. If required, you can apply adjustments to the payout.

Refund a multi-currency order​

Refunds are always processed and returned in the currency the buyer used to place the order. If the buyer pays in Canadian dollars on a US-based marketplace, they will be refunded in Canadian dollars.

Currency risk​

Currency rates fluctuate. This means the rate at the time of payment may differ from the rate at the time of refund.

The buyer must always receive back the exact amount they paid in their currency. Therefore, the risk of changing currency rates falls on the marketplace operator, as the merchant of record.

Conversely, if you deduct the refund amount from a seller's payout, the seller faces the currency risk. The payout is processed in the operator's local currency, and the amount for the refund will be converted from the buyer's currency again on the payout day.

Example

Initial order

You run a marketplace that accepts both USD and CAD, but your domiciled currency is USD. A Canadian customer purchases a product for $100 CAD.

At the time of this payment, the exchange rate is $1 CAD to $0.80 USD, so the amount is converted to $80 USD.

Return and refund

Weeks later, the customer decides to return the product. You issue a refund of $100 CAD, as that was the original purchase amount. However, the exchange rate has now changed: $1 CAD equals $0.85 USD.

To complete the refund, you must convert $85 USD, which is $5 more than the original $80 USD you received.

Learn more about operating in multiple currencies.

Refund to multiple payment methods​

When an order is paid using multiple payment methods, refunds are issued up to the original payment amount for each method.

Example

Consider an order of $1000, split between two payment methods:

  • Payment 1: $600
  • Payment 2: $400

If a refund of $500 was issued, it would go back to Payment 1, as it's the earliest payment and has sufficient funds.

If a refund of $700 was issued, Payment 1 will be refunded in full ($600), and the remaining $100 will be refunded to Payment 2.

Was this page helpful?