Skip to main content

Troubleshooting Failed Dispatches

Common reasons a payout dispatch fails and how to resolve each one.

Most dispatch failures fall into a handful of categories. The order is validated and charged atomically — if a dispatch fails, no records are created, and your balance is untouched, so you can fix the cause and retry safely.

Insufficient balance

  • Cause: Your company's balance is below the order total.

  • Solution: Top up the company balance for the relevant currency and retry. Nothing was charged on the failed attempt.

Duplicate email error

  • Cause: Two or more recipients in the same order share an email address (matching is case-insensitive).

  • Solution: Deduplicate the recipient list and retry.

Recipient limit error

  • Cause: The order contains more than 1,000 recipients.

  • Solution: Split the recipient list across multiple payout orders (max 1,000 each).

Redemption email not received

  • Cause: Invalid email address, the email landed in spam, or a provider-side delivery delay.

  • Solution: Verify the recipient address is correct and ask them to check their spam folder. Most provider-side issues resolve on retry.

Cross-currency redemption fails for worldwide (WW) products

  • Cause: The recipient's currency has no match among the campaign's selected products.

  • Solution: Add a brand with a matching currency, or align the recipient's currency to one supported by the campaign's brand mix.

Redemption link has expired

  • Cause: The payout exceeded the default expiration window before being redeemed.

  • Solution: dispatch a new payout. The expired balance is automatically refunded to your company balance.

Did this answer your question?