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.
