Understanding Transaction Statuses

Every reward transaction in your Oshi dashboard has a status that tells you where it is in its lifecycle. Understanding these statuses helps you track reward distribution, identify issues, and manage your rewards budget.

Status Definitions

Claimed (Green)

The customer successfully claimed their Bitcoin reward. The sats have been delivered to their wallet. This is the ideal end state for a transaction.

Pending (Yellow)

The reward has been created but the customer hasn't claimed it yet. Pending rewards are waiting for the customer to open their claim link (typically sent via email or shown on the Thank You page).

Rewards remain in pending status until the customer claims them or the claim window expires.

Recycled (Gray)

The reward expired before the customer claimed it. When a pending reward passes its claim window, it's recycled — meaning the sats are returned to your rewards balance and can be used for future rewards.

Recycled rewards are not lost. They go back into your available balance automatically.

Opt-Out

The customer explicitly declined marketing communications during checkout — they did not check the box to receive marketing or offers. Because of this, Oshi can't send them an email with an opportunity to join the rewards program and claim their Bitcoin, so the reward can't be delivered.

In cases where a purchase also triggered a referral bonus, the transaction may show as Ineligible instead of Opt-Out.

Clawback / Partial Clawback (Orange)

The reward was returned due to a refund or chargeback on the original purchase. When a customer returns an item or initiates a chargeback, the associated reward is clawed back.

• Full clawback — The entire reward is returned to your balance
• Partial clawback — Only a portion of the reward is returned (for example, if the customer returned one item from a multi-item order)

Hover over a clawback status to see a tooltip with the original reward amount, the clawed-back amount, and the adjusted amount.

Unpaid

Transactions in the Unpaid tab that are waiting for you to fund and process. These are typically from manually uploaded transactions or platforms that require manual payout.

How Statuses Apply to Bonuses

When a purchase triggers nested bonuses (referrals, commissions, offers), each bonus tracks its own status independently. For example:

• A purchase reward might be claimed, while the associated referral bonus is still pending
• A referral can have separate clawback tracking for the referee (the customer) and the referrer (the person who referred them)
• An affiliate commission can be clawed back independently from the purchase reward

This means a single transaction can have mixed statuses across its components.

What's Next

• Understanding your reward activity — Learn how to read the full Reward Activity table.
• How to filter and search transactions — Filter by status to find specific transactions.
• How to resolve an unpaid rewards balance — Handle unpaid transactions and funding.