Buy a domain through instant purchase

Overview

Instant purchase lets you buy closeout (Buy Now) auction domains at a fixed price without bidding. The workflow is synchronous. You preview the all-in cost, then execute the purchase. Domains fulfillment begins immediately on success. The following diagram shows the workflow for instant purchase:

The following article provides a workflow for buying domains through instant purchase.

Prerequisites

The following prerequisites are required before you can buy domains through instant purchase:

• a GoDaddy account with a payment profile configured
• a legacy API key, exported as GODADDY_API_KEY in your environment
• one or more domain names that have active closeout auction listings on GoDaddy Auctions

Get eligible payment profiles

The following procedure retrieves the payment profiles on your account that are eligible for instant purchase. Note the paymentProfileId (you'll use it to execute the purchase.

• List eligible payment profiles:

  curl -s "https://api.godaddy.com/v1/customers/MY/paymentProfiles" \
    -H "Authorization: sso-key $GODADDY_API_KEY"

The following is an example response:

{
  "paymentProfiles": [
    {
      "paymentProfileId": 377693,
      "currencyId": "USD",
      "label": "6341",
      "category": "CREDIT_CARD",
      "status": "ACTIVE",
      "subCategory": "Visa",
      "expMonth": 7,
      "expYear": 2030
    }
  ]
}

Preview pricing

The following procedure retrieves the all-in price for up to 10 domains before you commit to purchasing. You can preview and purchase up to 10 domains per request.

totalPrice includes the auction price, renewal or transfer fee, ICANN fee, and applicable taxes. All prices are in micro-units. Divide by 1,000,000 for the dollar amount (for example, 61990000 = $61.99).

• Request a pricing preview:

  curl -s -X POST "https://api.godaddy.com/v1/customers/MY/auctions/purchases/preview" \
    -H "Authorization: sso-key $GODADDY_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "domains": ["example.com", "mybrand.net"]
    }'

The following is an example response (207 — one domain priced, one not found):

{
  "currencyId": "USD",
  "auctions": [
    {
      "domainName": "example.com",
      "status": "SUCCESS",
      "auctionId": 690467872,
      "auctionPrice": 50000000,
      "totalPrice": 61990000
    },
    {
      "domainName": "mybrand.net",
      "status": "FAILED",
      "failureReason": "AUCTION_NOT_FOUND"
    }
  ]
}

Only pass domains with status: "SUCCESS" to the purchase step. Note the totalPrice for each. You'll need the exact value to execute the purchase.

Execute purchase

The following procedure purchases the domains you previewed. Pass the totalPrice from the preview pricing step exactly. If the price has changed since the preview, the domain fails with PRICE_MISMATCH and you'll need to re-run the preview.

• Execute the purchase:

  curl -s -X POST "https://api.godaddy.com/v1/customers/MY/auctions/purchases" \
    -H "Authorization: sso-key $GODADDY_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "currencyId": "USD",
      "paymentProfileId": 377693,
      "domains": [
        {
          "domainName": "example.com",
          "totalPrice": 61990000,
          "acceptTos": true
        }
      ]
    }'

The following is an example response (200 — all purchased):

{
  "currencyId": "USD",
  "orderDetails": {
    "orderId": "4028591294"
  },
  "auctions": [
    {
      "domainName": "example.com",
      "status": "SUCCESS",
      "auctionId": 690467872,
      "totalPrice": 61990000
    }
  ]
}

If the response is 207, inspect each domain's status and failureReason. Domains with status: "SUCCESS" were purchased and charged. Domains with status: "FAILED" wern't charged.

Error reference

Last updated on