Loading…
You collect payment from your buyer on your own checkout. Once the buyer pays, you notify name.ai via POST /v1/orders. We transfer the domain to your registrar and issue a settlement statement. You remit our share net-45.
Lock the price for 10 minutes. Returns a signed quote_id that you pass to POST /orders.
POST /api/partner/v1/quotes
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" }{
"quote_id": "qt_01JXYZ...",
"domain": "custodylawyer.com",
"price_cents": 2500000,
"currency": "USD",
"expires_at": "2026-06-08T07:20:00Z"
}Notify name.ai that you have collected payment. Idempotency-Key is required — use the same key on retries of the same operation; generate a new one for new orders.
| Field | Required | Description |
|---|---|---|
| domain | Yes | Domain name, lowercase. |
| sale_price_cents | Yes | Amount charged to buyer, in USD cents. Must match current listing price. |
| currency | Yes | Must be "USD". |
| external_payment_ref | Yes | Your payment gateway's charge/transaction ID for reconciliation. |
| quote_id | Recommended | From POST /quotes. Locks the price and proves you held it. |
| buyer.email | Yes | Buyer's email address. |
| buyer.name | No | Buyer's full name (encrypted at rest). |
| buyer.country | No | ISO 3166-1 alpha-2 country code. |
| buyer.ip | No | Buyer IP for fraud scoring (hashed at rest). |
| metadata | No | Up to 50 key/value pairs (keys ≤120 chars, values ≤500 chars). |
POST /api/partner/v1/orders
Content-Type: application/json
Idempotency-Key: ord_7f3a9b2c-...
X-NameAI-Key-Id: pk_live_xxx
X-NameAI-Timestamp: <ts>
X-NameAI-Nonce: <uuid>
X-NameAI-Signature: v1=<hmac>
{
"domain": "custodylawyer.com",
"sale_price_cents": 2500000,
"currency": "USD",
"external_payment_ref": "pi_3OkAbc...",
"quote_id": "qt_01JXYZ...",
"buyer": {
"email": "buyer@example.com",
"name": "Jane Doe",
"country": "US",
"ip": "1.2.3.4"
}
}{
"public_id": "ord_01JABC...",
"status": "EXTERNALLY_PAID",
"delivery": "awaiting_admin",
"amount": 2500000,
"currency": "USD",
"transfer_method": "INTERNAL_PUSH",
"manual_review_required": false
}order.manual_review_cleared webhook.Poll GET /api/partner/v1/orders/{public_id} or subscribe to webhooks (recommended) to track the transfer lifecycle.
{
"public_id": "ord_01JABC...",
"domain": "custodylawyer.com",
"status": "TRANSFER_COMPLETED",
"sale_price_cents": 2500000,
"currency": "USD",
"buyer_email": "buyer@example.com",
"created_at": "2026-06-08T07:00:00Z",
"updated_at": "2026-06-08T09:15:00Z"
}Next: Settlement → · Webhooks & events →