Retrieve Payment Levels Rebate
Returns the part of its account’s monthly Whop Levels rebate a card payment earned: the processing fee above its level’s rate, once the month its fee posted in has closed. The rebate is paid to the account as one sum each month, so the payment’s own amounts and fees never change.
Authorizations
An Account API key, an App API key, an account access token, an account-scoped user token, or a user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.
Scopes
Headers
Pins the request to a dated API version.
"2026-11-07"
Path Parameters
The payment whose rebate to retrieve, prefixed pay_.
Response
rebate retrieved
Part of the account's monthly rebate this payment earned, in the currency it settled in. The rebate is paid to the account as one sum, so the payment's own amounts and fees don't change. null unless status is rebated.
How much of the payment the month's spend covered, from 0 to 1: 1 for every rebated payment but the month's last, which can be covered in part, so its rebate is that share of the fee above the level's rate. null unless status is rebated.
1
Processing fee as a percentage of the amount it was charged on, before the rebate, where 2.7 means 2.7%. null unless status is rebated.
2.7
Why the payment can't earn a rebate: not_card_payment, before_levels (made before Whop Levels started), not_in_levels (its account wasn't in Whop Levels that month), fee_not_posted, fee_at_level_rate (its fee was already at or below the level's rate) or no_level_rate (its fee matched no level rate). null unless status is ineligible.
not_card_payment, before_levels, not_in_levels, fee_not_posted, fee_at_level_rate, no_level_rate, null "not_card_payment"
Level the account's month closed at, from 0 up to 10. null until that month's close has applied to the payment, and for a payment that can't earn a rebate before then, such as a non-card payment.
3
Start of the UTC month whose close covers this payment, as an ISO 8601 timestamp. null before the processing fee has posted, and for a payment that can't earn a rebate before then, such as a non-card payment.
"2026-10-01T00:00:00.000Z"
Payment ID, prefixed pay_.
"pay_xxxxxxxxxxxxxx"
Card processing percentage at level for cards from region, where 2.1 means 2.1%. The rebate is the fee above it. null unless status is rebated.
2.1
Card region the processing fee was charged in, which sets processing_rate_percentage. null unless status is rebated.
us_and_canada, europe_uk_and_australia, latin_america, peru, brazil, null "us_and_canada"
rebated when the payment earned part of its account's monthly Whop Levels rebate. pending until the month its processing fee posted in has closed. not_covered when the account's spend that month ran out before this payment. ineligible when it can't earn one; ineligible_reason says why.
rebated, pending, not_covered, ineligible "rebated"

