orders

Instant Register domain

Purchase a single domain instantly without adding to cart. Validates domain availability, creates payments and order, then starts the order processing workflow. Payment is taken from the NFSC balance first; any remainder is charged to the credit card saved on the Namefi profile. Card legs are at least $1.00 — when the shortfall is smaller, the card is charged $1.00 and correspondingly less NFSC is used. If neither rail covers the price, the request fails with links to top up NFSC or save a card. The payments array in the response shows the planned split; legs are charged asynchronously after the order is created.

post/orders/register-domain

Request

  • Base URL: https://api.namefi.io/v-next
  • URL: https://api.namefi.io/v-next/orders/register-domain
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Headers

x-namefi-eip7702-accountstring

Optional delegated account address to authenticate as when the signer is an approved signer. Preferred header name.

x-namefi-eip1271-accountstring

Legacy alias for x-namefi-erc1271-account. When multiple delegated account headers are present, x-namefi-eip7702-account takes precedence, then x-namefi-erc1271-account.

x-namefi-erc1271-accountstring

Optional delegated account address to authenticate as when the signer is an approved signer. Preferred ERC-1271 header name.

Request body

OR

Response

OK

idstring required
userIdstring required
amountInUSDCentsnumber required
nftWalletAddressstring nullable required
nftChainIdnumber nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.