Skip to main content
Redeems a promo code that adds money to the user’s cash balance. Each code works once per user; the credit lands in the balance and becomes spendable within a minute or two. See what the user has already redeemed or can retry with list_codes.

​
Parameters

​
Returns

On success, a confirmation with the credited amount; check get_balance to watch it land. Failure cases tell you what happened: invalid_code (check for typos and retry), expired, exhausted (the code hit its redemption limit), already_redeemed (each code works once per user), or in_progress (a redemption from a moment ago is still processing; don’t retry, the credit is on the way).

​
Example