domain_purchase.completed

Fires when a purchase has been charged AND registered at the upstream registrar. By the time you receive this, the domain is legally registered to your end-user.

Payload

{
  "id": "<event-id>",
  "type": "domain_purchase.completed",
  "createdAt": "2026-05-17T15:42:11.000Z",
  "data": {
    "purchase": {
      "id": "f8a0c1b9-1234-…",
      "hostname": "janesbakery.com",
      "years": 1,
      "wholesaleCents": 1418,
      "feeCents": 100,
      "totalCents": 1518,
      "currency": "USD",
      "registrar": "namecheap",
      "registrarDomainId": "182739",
      "status": "completed",
      "registrant": {
        "firstName": "Jane",
        "lastName": "Smith",
        "email": "jane@bakery.example",
        "country": "US"
      },
      "whoisPrivacyEnabled": true,
      "autoRenew": false,
      "expiresAt": "2027-05-17T15:42:11.000Z",
      "customerReference": "user_jane_42",
      "createdAt": "2026-05-17T15:42:09.000Z",
      "updatedAt": "2026-05-17T15:42:11.000Z"
    }
  }
}

Use it for

• Sending a confirmation email to your end-user
• Provisioning the domain in your app (DNS, hostname routing)
• Calling POST /v1/domains to start proxying the hostname through Domainee's edge
• Updating your own ledger / invoice / receipts