{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://shopify.dev/ucp/shop-pay-handler/2026-08-25/checkout.json",
  "name": "dev.shopify.shop_pay",
  "title": "Shop Pay Checkout Extension",
  "description": "Extends checkout with the dev.shopify.shop_pay Action, which a merchant returns when Shop Pay needs the buyer to authenticate a payment.",
  "$defs": {
    "shop_pay_actions": {
      "type": "object",
      "properties": {
        "actions": {
          "type": "object",
          "ucp_request": "omit",
          "properties": {
            "dev.shopify.shop_pay": {
              "type": "array",
              "description": "A Shop Pay authentication Action.",
              "items": {
                "type": "object",
                "required": [
                  "config"
                ],
                "properties": {
                  "config": {
                    "type": "object",
                    "required": [
                      "payment_instrument_id",
                      "url"
                    ],
                    "properties": {
                      "payment_instrument_id": {
                        "type": "string",
                        "minLength": 1,
                        "description": "The Shop Pay instrument the challenge belongs to."
                      },
                      "url": {
                        "type": "string",
                        "format": "uri",
                        "description": "The challengeUrl that the buyer must interact with."
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "dev.ucp.shopping.checkout": {
      "allOf": [
        {
          "$ref": "https://ucp.dev/2026-08-25/schemas/shopping/checkout.json"
        },
        {
          "$ref": "#/$defs/shop_pay_actions"
        }
      ]
    }
  }
}