1. Administrator: connect the registrar
Open Admin → DNS providers → Domain marketplace pricing. Choose Namecheap or Name.com. For Namecheap, enable API Access in your registrar account and add the production server’s outbound IPv4 to its allowlist. Enter the API username, API key and IPv4 in the form, or first connect the same account under My Namecheap domains for short links and choose Use this account for domain sales. The latter copies credentials securely on the server and leaves sales OFF. Use Sandbox credentials only with Sandbox mode. Set the price markup (default 20%), save, and test the connection before enabling sales. Configure Stripe or PayPal in the same test/live environment as the registrar. A registrar account login alone does not grant API access.
2. Search current registrar availability
Open Add Domain → Buy a domain. Search a brand or full registrable domain name. Availability and one-year prices come from the connected registrar; local database absence is never treated as proof of availability. Namecheap premium and early-access names, and TLDs without a reliable one-year registration and renewal price, are excluded from automatic checkout. Quotes expire after ten minutes. Prices are in USD and include the displayed operator markup, including any registrar ICANN fee.
3. Supply accurate registration contacts
Select Register and fill in the contact form. Use a two-letter country code and an international phone number beginning with +; Namecheap accepts +countrycode.number. Review the contact-sharing consent and the connected registrar agreement. Namecheap registers the domain under the operator’s registrar account using the customer’s supplied registrant, administrative, technical and billing contacts. The registrar may email you to verify the registrant contact.
4. Pay through the configured provider
Choose Card / Stripe or PayPal. Continue to secure payment opens the provider checkout. Card details are handled by the payment provider. The application rechecks the quote before checkout, then independently retrieves payment status, amount, currency and order references. A browser return URL cannot mark an order paid. Registration does not change your subscription plan.
5. Verify registration and finish DNS
Open Purchased Domains. Use Verify payment / registration to refresh an order; the scheduled Domain order verification job also processes it. A confirmed registrar purchase must pass a separate domain lookup. Live registrations create a domain with DNS pending, and attempt to add the required A and CNAME records without replacing conflicting records. Complete DNS setup selects that domain and opens its configuration. Public DNS and SSL readiness remain separate checks. Sandbox orders are labelled and do not create real domain entries or real revenue.
6. Recover failed or uncertain orders
Administrators see order state, error and Verify / retry order in DNS providers. Requests use a durable lease. Name.com registration retries use its request key; Namecheap does not provide a registration idempotency key, so an uncertain Namecheap response is reconciled with a domain ownership lookup and is never blindly purchased a second time. If ownership cannot be confirmed, the order stays for administrator review. Confirmed price or availability changes before registration produce Refund verified payment. Refunds remain pending until the payment provider confirms success.
Renewals and operator controls
This checkout purchases one year. It does not authorize recurring charges. Contact support before expiry to arrange renewal; no local-only auto-renew switch claims that a registrar renewal has been scheduled. Turning the marketplace OFF stops new registrations while payment verification remains available. Live registration requires a funded registrar account, configured payment credentials and a correct public redirect IP. Never enable live registrar credentials together with test payment credentials.
API example
Create a quote using GET /api/domains/search?q=yourbrand. Then POST /api/domains/checkout as a workspace owner or administrator with quoteId, gateway, consent:true and registrant fields: firstName, lastName, address1, city, state, zip, country, email and phone. Optional fields are companyName and address2. Use the returned checkoutUrl; ignore any client-calculated amount. Read orders using GET /api/purchased-domains and verify one using POST /api/domains/orders/{id}/verify.
Namecheap API access · Namecheap pricing API · Namecheap registration API · Name.com integration guide
Find this in your dashboard
- Sign in and select the workspace and domain you want to manage.
- Open Domains. Review the article’s steps and your plan’s available controls.
- Save your changes, reopen the record and verify the saved result. For routing changes, check the short link with a test visit.
