Skip to content

Knowledgebase

Validate rewards and promotions through the quote engine

domain-nexus, development

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

01 Check eligibility before checkout

  1. Read the rewards summary and applicable programme policy. Review earning, redemption, expiry or reversal transactions when the balance needs explanation.
  2. Prepare the exact domain, action and years for the order. Registration, renewal and transfer can have different eligibility and prices.
  3. POST the optional promo_code and requested reward_points to promotions/validate. Include a configured currency_id only when you intentionally use that permitted currency.
  4. Read the quote's actual discounts, points treatment, total, currency and expiry. Present those values rather than recalculating a promotional total in the browser.
  5. 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.

Was this answer helpful?

Need a little more help?

Our support team can help you find the next step.

Contact support