Buy a domain with a machine payment (no account)

Changed on

Buy a domain with no account, API key or browser, paid with Stripe machine payments (MPP). Call once without credentials to get a 402 WWW-Authenticate: Payment challenge for the final first-year price, then retry the same request with Authorization: Payment <credential> (for example a Link shared payment token). The domain is registered for one year to contact, owned by email (default contact.email), who is emailed a link to claim the account.

The price is always the server's quote; a body cannot set it. If the quote changes between calls the retry gets a fresh 402. If registration fails after payment while the domain is still for sale, the payment is refunded (502); if the outcome is unclear, the order is reviewed by hand (202) and the owner is emailed.

post/domains/buy/mpp

Request

  • Base URL: https://namemy.app/api/v1
  • URL: https://namemy.app/api/v1/domains/buy/mpp
  • Auth: none required

Request body

domainstring required
years1
emailstring email

Owner account email. Defaults to contact.email.

Example request

{
  "domain": "taskflow.app"
}

Response

Paid and registered. Carries a Payment-Receipt header.

domainstring
orderIdstring
pricePaidnumber
renewalPricenumber
currencystring

Example response

{
  "pricePaid": 12.6,
  "currency": "usd"
}

Changes