Ace Hardware · JSON Structure

Ace Hardware Affiliate Referral Structure

An affiliate referral event tracking a publisher's referral of a customer to acehardware.com via the Impact affiliate network.

Type: object Properties: 12 Required: 3

RetailHardwareHome ImprovementToolsPaintCooperativeEDIAffiliate

AceHardwareAffiliateReferral is a JSON Structure definition published by Ace Hardware, describing 12 properties, of which 3 are required. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

referralId affiliateId affiliateName referralUrl destinationUrl clickDate conversionDate orderId orderValue commissionRate commissionAmount status

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/ace-hardware/refs/heads/main/json-structure/ace-hardware-affiliate-referral-structure.json",
  "name": "AceHardwareAffiliateReferral",
  "description": "An affiliate referral event tracking a publisher's referral of a customer to acehardware.com via the Impact affiliate network.",
  "type": "object",
  "properties": {
    "referralId": {
      "type": "uuid",
      "description": "Unique identifier for this referral event",
      "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
    },
    "affiliateId": {
      "type": "string",
      "description": "Impact affiliate account identifier",
      "example": "AFF-500123"
    },
    "affiliateName": {
      "type": "string",
      "description": "Name of the affiliate publisher",
      "example": "Home Improvement Blog"
    },
    "referralUrl": {
      "type": "uri",
      "description": "URL of the affiliate's referring page",
      "example": "https://www.homeimprovementblog.com/best-hammers"
    },
    "destinationUrl": {
      "type": "uri",
      "description": "Ace Hardware product page the customer was referred to",
      "example": "https://www.acehardware.com/departments/tools/hand-tools/hammers"
    },
    "clickDate": {
      "type": "datetime",
      "description": "Date and time the affiliate link was clicked",
      "example": "2026-04-19T10:30:00Z"
    },
    "conversionDate": {
      "type": "datetime",
      "description": "Date and time the purchase was completed",
      "example": "2026-04-19T11:15:00Z"
    },
    "orderId": {
      "type": "string",
      "description": "Ace Hardware order identifier from the converted sale",
      "example": "ORD-2026-789012"
    },
    "orderValue": {
      "type": "double",
      "description": "Total order value in USD",
      "example": 89.97
    },
    "commissionRate": {
      "type": "double",
      "description": "Commission percentage earned by the affiliate",
      "example": 4.5
    },
    "commissionAmount": {
      "type": "double",
      "description": "Commission amount earned in USD",
      "example": 4.05
    },
    "status": {
      "type": "string",
      "description": "Status of the commission",
      "enum": [
        "Pending",
        "Approved",
        "Rejected",
        "Paid"
      ],
      "example": "Approved"
    }
  },
  "required": [
    "referralId",
    "affiliateId",
    "clickDate"
  ]
}