Non-MoR — name.ai collects payment

Pay with name.ai

Name.ai handles payment, buyer registration, and domain transfer. You generate a hosted checkout link and redirect your buyer to it. Your commission is credited at settlement. This option is available to every partner — it's the only option for non-MoR partners.

End-to-end flow

1
Search inventoryBuyer searches your site → you call GET /domains/search → show available domains.
2
Create checkout sessionCall POST /checkout-session with the domain. Returns a checkout_url that expires in 7 days.
3
Redirect your buyerSend the buyer to checkout_url. They land on the name.ai lander for that domain.
4
Buyer authenticatesBuyer registers or logs in on the lander (self-serve — no invite required for partner-referred buyers).
5
Buyer paysMoR partners see the price immediately; non-MoR buyers unlock the price after registration. Buyer pays via Stripe on the lander.
6
Name.ai deliversWe transfer the domain and record the sale against your partner account.
7
SettlementYour commission is included in the next settlement statement (GET /settlements).

POST

/api/partner/v1/checkout-session

scope: embed

Returns a hosted lander URL (checkout_url) that carries a signed partner-origin token. Send your buyer to this URL.

Field	Required	Description
domain	Yes	Domain the buyer wants to purchase.
return_url	No	Where to redirect the buyer after successful purchase.
cancel_url	No	Where to redirect the buyer if they leave without buying.

Request

POST /api/partner/v1/checkout-session
Content-Type: application/json
X-NameAI-Key-Id: pk_live_xxx
X-NameAI-Timestamp: <ts>
X-NameAI-Nonce: <uuid>
X-NameAI-Signature: v1=<hmac>

{
  "domain": "custodylawyer.com",
  "return_url": "https://yoursite.com/success",
  "cancel_url": "https://yoursite.com/domains"
}

Response 200

{
  "checkout_url": "https://name.ai/lander/custodylawyer.com?pt=eyJhbGci...",
  "domain": "custodylawyer.com",
  "price_cents": 2500000,
  "currency": "USD",
  "payment_model": "name_ai_collected",
  "expires_in_seconds": 604800
}

MoR vs non-MoR lander behaviour: If your account is Merchant of Record, the buyer sees the price immediately on the lander. If you are non-MoR, the price is hidden until the buyer registers/logs in — then it unlocks and the Buy Now button appears.

How attribution works

The checkout_url contains a signed ?pt= token that encodes your partner ID. When the buyer completes payment on the lander, name.ai records the sale against your partner account. You see it in GET /transactions and GET /settlements.

The token is valid for 7 days. Generate a fresh checkout session per buyer session — do not cache and share one URL across buyers.

Next: Settlement →