In light of COVID-19, please review the latest announcement regarding the Reserve with Google guidelines for supporting users and merchants during this time. Additionally, since we are operating with a limited support team, it may take longer to connect with us. Thank you for your patience, and we value your partnership.

Merchants feed

An example merchants feed is provided below. Note that in this example, shard_number is left out of the metadata despite being required because it would be the default value of zero (shards are zero-indexed). Any variable left out of the feed will get its default value.

Example

JSON

{
  "merchant": [
    {
      "category": "gym",
      "geo": {
        "address": {
          "country": "USA",
          "locality": "Mountain View",
          "postal_code": "94043",
          "region": "CA",
          "street_address": "1600 Amphitheatre Pkwy"
        },
        "latitude": 37.422113,
        "longitude": -122.084041
      },
      "merchant_id": "1000-0",
      "name": "Merchant 0",
      "payment_option": [
        {
          "activation_type": "ACTIVATION_ON_FIRST_USE",
          "description": "A membership available nation-wide",
          "name": "Universal Membership",
          "payment_option_id": "universal1",
          "payment_option_type": "PAYMENT_OPTION_UNLIMITED",
          "price": {
            "currency_code": "USD",
            "price_micros": 49000000
          },
          "purchase_interval": {
            "begin_sec": 1487318400,
            "end_sec": 1518854400
          },
          "tax_rate": {
            "micro_percent": 8500000
          },
          "valid_interval": {
            "begin_sec": 1487318400,
            "end_sec": 1548921600
          }
        },
        {
          "activation_type": "ACTIVATION_ON_FIRST_USE",
          "description": "A pack of 10 can only be used at Merchant 0",
          "name": "10 Pack",
          "payment_option_id": "merch-1000-0-pack10",
          "payment_option_type": "PAYMENT_OPTION_MULTI_USE",
          "price": {
            "currency_code": "USD",
            "price_micros": 19000000
          },
          "purchase_interval": {
            "begin_sec": 1487318400,
            "end_sec": 1518854400
          },
          "tax_rate": {
            "micro_percent": 8500000
          },
          "user_restriction": {
            "new_to_merchant": true
          },
          "valid_duration_sec": 2592000
        },
        {
          "activation_type": "ACTIVATION_ON_FIRST_USE",
          "description": "This payment option can be applied at the availability slot level to assign different prices for staff members performing the same service.",
          "name": "Alice Staff Pack",
          "payment_option_id": "merch-1000-0-staff-Alice",
          "payment_option_type": "PAYMENT_OPTION_UNLIMITED",
          "price": {
            "currency_code": "USD",
            "price_micros": 49000000
          },
          "purchase_interval": {
            "begin_sec": 1487318400,
            "end_sec": 1518854400
          },
          "tax_rate": {
            "micro_percent": 8500000
          },
          "valid_interval": {
            "begin_sec": 1487318400,
            "end_sec": 1548921600
          }
        },
        {
          "activation_type": "ACTIVATION_ON_FIRST_USE",
          "description": "This payment option can be applied at the availability slot level to assign different prices for staff members performing the same service.",
          "name": "Bob Staff Pack",
          "payment_option_id": "merch-1000-0-staff-Bob",
          "payment_option_type": "PAYMENT_OPTION_UNLIMITED",
          "price": {
            "currency_code": "USD",
            "price_micros": 59000000
          },
          "purchase_interval": {
            "begin_sec": 1487318400,
            "end_sec": 1518854400
          },
          "tax_rate": {
            "micro_percent": 8500000
          },
          "valid_interval": {
            "begin_sec": 1487318400,
            "end_sec": 1548921600
          }
        },
        {
          "activation_type": "ACTIVATION_ON_FIRST_USE",
          "description": "This payment option can be applied at the availability slot level to assign different prices for staff members performing the same service.",
          "name": "Chris Staff Pack",
          "payment_option_id": "merch-1000-0-staff-Chris",
          "payment_option_type": "PAYMENT_OPTION_UNLIMITED",
          "price": {
            "currency_code": "USD",
            "price_micros": 69000000
          },
          "purchase_interval": {
            "begin_sec": 1487318400,
            "end_sec": 1518854400
          },
          "tax_rate": {
            "micro_percent": 8500000
          },
          "valid_interval": {
            "begin_sec": 1487318400,
            "end_sec": 1548921600
          }
        }
      ],
      "tax_rate": {
        "micro_percent": 7500000
      },
      "telephone": "+1 650-253-0000",
      "tokenization_config": {
        "tokenization_parameter": {
          "gateway": "stripe",
          "stripe:publishableKey": "pubkey_1234",
          "stripe:version": "1.5"
        }
      },
      "url": "www.google.com"
    },
    {
      "category": "gym",
      "geo": {
        "address": {
          "country": "USA",
          "locality": "Mountain View",
          "postal_code": "94043",
          "region": "CA",
          "street_address": "1600 Amphitheatre Pkwy"
        },
        "latitude": 37.422113,
        "longitude": -122.084041
      },
      "merchant_id": "1000-1",
      "name": "Merchant 1",
      "num_bookings_30d": 10,
      "payment_option": [
        {
          "activation_type": "ACTIVATION_ON_FIRST_USE",
          "description": "A membership available nation-wide",
          "name": "Universal Membership",
          "payment_option_id": "universal1",
          "payment_option_type": "PAYMENT_OPTION_UNLIMITED",
          "price": {
            "currency_code": "USD",
            "price_micros": 49000000
          },
          "purchase_interval": {
            "begin_sec": 1487318400,
            "end_sec": 1518854400
          },
          "tax_rate": {
            "micro_percent": 8500000
          },
          "valid_interval": {
            "begin_sec": 1487318400,
            "end_sec": 1548921600
          }
        },
        {
          "activation_type": "ACTIVATION_ON_FIRST_USE",
          "description": "A pack of 20 can only be used at Merchant 1",
          "name": "20 Pack",
          "payment_option_id": "merch-1000-1-pack20",
          "payment_option_type": "PAYMENT_OPTION_MULTI_USE",
          "price": {
            "currency_code": "USD",
            "price_micros": 39000000
          },
          "purchase_interval": {
            "begin_sec": 1487318400,
            "end_sec": 1518854400
          },
          "tax_rate": {
            "micro_percent": 8500000
          },
          "user_restriction": {
            "new_to_payment_option": true
          },
          "valid_duration_sec": 2592000
        }
      ],
      "payment_restrictions": {
        "credit_card_restrictions": {
          "credit_card_type": [
            "VISA",
            "MASTERCARD"
          ]
        }
      },
      "tax_rate": {
        "micro_percent": 7500000
      },
      "telephone": "+1 650-253-0000",
      "tokenization_config": {
        "tokenization_parameter": {
          "braintree:apiVersion": "1.5",
          "braintree:clientKey": "pubkey_5678",
          "braintree:merchantId": "abcdef",
          "braintree:sdkVersion": "none",
          "gateway": "braintree"
        }
      },
      "url": "www.google.com"
    },
    {
      "category": "gym",
      "geo": {
        "address": {
          "country": "USA",
          "locality": "Mountain View",
          "postal_code": "94043",
          "region": "CA",
          "street_address": "1600 Amphitheatre Pkwy"
        },
        "latitude": 37.422113,
        "longitude": -122.084041
      },
      "merchant_id": "1000-2",
      "name": "Merchant 2",
      "num_bookings_30d": 10,
      "payment_option": [
        {
          "activation_type": "ACTIVATION_ON_FIRST_USE",
          "description": "A membership available nation-wide",
          "name": "Universal Membership",
          "payment_option_id": "universal1",
          "payment_option_type": "PAYMENT_OPTION_UNLIMITED",
          "price": {
            "currency_code": "USD",
            "price_micros": 49000000
          },
          "purchase_interval": {
            "begin_sec": 1487318400,
            "end_sec": 1518854400
          },
          "tax_rate": {
            "micro_percent": 8500000
          },
          "valid_interval": {
            "begin_sec": 1487318400,
            "end_sec": 1548921600
          }
        },
        {
          "activation_type": "ACTIVATION_ON_FIRST_USE",
          "description": "A pack of 10 can only be used at Merchant 2",
          "name": "10 Pack",
          "payment_option_id": "merch-1000-2-pack10",
          "payment_option_type": "PAYMENT_OPTION_MULTI_USE",
          "price": {
            "currency_code": "USD",
            "price_micros": 19000000
          },
          "purchase_interval": {
            "begin_sec": 1487318400,
            "end_sec": 1518854400
          },
          "tax_rate": {
            "micro_percent": 8500000
          },
          "user_restriction": {
            "new_to_merchant": true
          },
          "valid_duration_sec": 2592000
        }
      ],
      "payment_restrictions": {
        "credit_card_restrictions": {
          "credit_card_type": [
            "AMERICAN_EXPRESS"
          ]
        }
      },
      "tax_rate": {
        "micro_percent": 7500000
      },
      "telephone": "+1 650-253-0000",
      "url": "www.google.com"
    }
  ],
  "metadata": {
    "generation_timestamp": 1470175790,
    "nonce": 1405785854235138178,
    "processing_instruction": "PROCESS_AS_COMPLETE",
    "total_shards": 1
  }
}
Download single-shard example in JSON format
Download multi-shard example in JSON format

PB3

Download single-shard example in PB3 format
Download multi-shard example in PB3 format