Use the authoritative quote workflow to check a promotion or proposed reward redemption for a specific domain operation. A displayed points balance or advertised percentage is not enough to calculate the final payable amount.
| Method | Resource | Scope | Idempotency-Key |
|---|---|---|---|
GET |
/v2/rewards |
wallet:read |
Not required by this route |
GET |
/v2/rewards/transactions |
wallet:read |
Not required by this route |
POST |
/v2/promotions/validate |
pricing:quote |
Required |
IN THIS ARTICLE
01 Check eligibility before checkout
- Read the rewards summary and applicable programme policy. Review earning, redemption, expiry or reversal transactions when the balance needs explanation.
- Prepare the exact
domain,actionandyearsfor the order. Registration, renewal and transfer can have different eligibility and prices. - POST the optional
promo_codeand requestedreward_pointstopromotions/validate. Include a configuredcurrency_idonly when you intentionally use that permitted currency. - Read the quote's actual discounts, points treatment, total, currency and expiry. Present those values rather than recalculating a promotional total in the browser.
- Complete the relevant domain operation through its normal quote and payment workflow. Validation alone does not execute or settle the purchase.
02 Handle changing prices and balances
A quote is tied to its inputs and validity period. Obtain a new quote after changing the term, operation, domain or requested redemption. Recheck when another order may have consumed points or when a promotion's time window has ended.
The API bounds the requested term to 1 through 10 years, but the selected TLD and operation may support fewer terms. A premium input flag is not independent evidence of a live premium-domain price. Use actual provider-backed pricing and required confirmation for such an order.
Common questions
Are reward points the same as wallet credit?
No. Points follow the configured programme's rules. They are not automatically cash, transferable money or an unrestricted wallet balance.
Does a successful validation reserve the promotion?
Do not assume it does. Follow the quote expiry and final order checks. A validation response by itself does not lock eligibility indefinitely.
Why did a displayed promotion not apply?
Compare the TLD, operation, term, account or tier eligibility, time window and requested points with the returned quote or error. Retain that evidence before changing the advertised offer.
How should I explain a reward reversal?
Use the linked transaction and original order evidence. A refund or other policy event can change the balance; do not silently treat a reversal as a new charge.