Affirm · JSON Structure

Promos Promo Config Structure

Internal configuration data returned with the promo response.

Type: object Properties: 7
FintechBNPLLendingPaymentsConsumer

PromoConfig is a JSON Structure definition published by Affirm, describing 7 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

promo_prequal_enabled merchant_name merchant_ari user_ari toast_enabled enabled_integrations images

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

JSON Structure

promos-promo-config-structure.json Raw ↑
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/affirm/refs/heads/main/json-structure/promos-promo-config-structure.json",
  "name": "PromoConfig",
  "description": "Internal configuration data returned with the promo response.",
  "type": "object",
  "properties": {
    "promo_prequal_enabled": {
      "type": "boolean",
      "description": "Indicates whether prequalification is enabled for this merchant.",
      "example": true
    },
    "merchant_name": {
      "type": "string",
      "description": "The merchant's display name.",
      "example": "Example Merchant"
    },
    "merchant_ari": {
      "type": "string",
      "description": "Affirm Resource Identifier for the merchant.",
      "example": "example_value"
    },
    "user_ari": {
      "type": "string",
      "description": "Affirm Resource Identifier for the current user session.",
      "example": "example_value"
    },
    "toast_enabled": {
      "type": "boolean",
      "description": "Indicates whether toast notifications are enabled for this integration.",
      "example": true
    },
    "enabled_integrations": {
      "type": "array",
      "description": "List of enabled Affirm integration features for this merchant.",
      "items": {
        "type": "string"
      },
      "example": [
        "example_value"
      ]
    },
    "images": {
      "type": "object",
      "description": "Image asset URLs for use in the promotional modal.",
      "properties": {
        "hero": {
          "type": "uri",
          "description": "Standard resolution hero image URL."
        },
        "hero2x": {
          "type": "uri",
          "description": "High resolution (2x) hero image URL."
        },
        "logo": {
          "type": "uri",
          "description": "Standard resolution Affirm logo URL."
        },
        "logo2x": {
          "type": "uri",
          "description": "High resolution (2x) Affirm logo URL."
        }
      },
      "example": {
        "hero": "https://example.com",
        "hero2x": "https://example.com",
        "logo": "https://example.com",
        "logo2x": "https://example.com"
      }
    }
  }
}