Upsert merchant

1 import requests 2 3 url = "https://api.cash.app/network/v1/merchants" 4 5 payload = { "merchant": { 6 "name": "merchant name", 7 "brand_id": "brand ID", 8 "country": "US", 9 "currency": "USD", 10 "category": "5432", 11 "reference_id": "reference ID", 12 "address": { 13 "country": "US", 14 "address_line_1": "1215 4th Ave", 15 "address_line_2": "Suite 2300", 16 "locality": "Seattle", 17 "postal_code": "98161-1001", 18 "administrative_district_level_1": "Washington" 19 }, 20 "site_url": "http://example.com", 21 "default_fee_plans": { 22 "in_app_fee_plan_id": "FEE_kewjsmjt35t8qhzyjeqcst5me", 23 "in_person_fee_plan_id": "FEE_kewjsmjt35t8qhzyjeqcst5me", 24 "online_fee_plan_id": "FEE_kewjsmjt35t8qhzyjeqcst5me" 25 } 26 } } 27 headers = { 28 "Accept": "Accept", 29 "X-Region": "X-Region", 30 "X-Signature": "X-Signature", 31 "User-Agent": "User-Agent", 32 "Content-Type": "application/json" 33 } 34 35 response = requests.put(url, json=payload, headers=headers) 36 37 print(response.json())

1 { 2 "merchant": { 3 "id": "MMI_4vxs5egfk7hmta3qx2h6rp91x", 4 "brand_id": "BRAND_8ereg0tug2yiik8vx24xpe5br", 5 "name": "Example Business Name", 6 "country": "US", 7 "currency": "USD", 8 "category": "5432", 9 "reference_id": "external-id", 10 "status": "ACTIVE", 11 "created_at": "2022-01-01T12:00:00Z", 12 "updated_at": "2022-01-05T12:00:00Z", 13 "address": { 14 "country": "US", 15 "address_line_1": "1215 4th Ave", 16 "address_line_2": "Suite 2300", 17 "locality": "Seattle", 18 "postal_code": "98161-1001", 19 "administrative_district_level_1": "Washington" 20 }, 21 "site_url": "string", 22 "metadata": {}, 23 "default_fee_plans": { 24 "in_app_fee_plan_id": "FEE_kewjsmjt35t8qhzyjeqcst5me", 25 "in_person_fee_plan_id": "FEE_kewjsmjt35t8qhzyjeqcst5me", 26 "online_fee_plan_id": "FEE_kewjsmjt35t8qhzyjeqcst5me" 27 } 28 } 29 }

Creates or updates a merchant based on the merchant’s reference_id.

If a merchant with a matching reference_id is found, it will be updated. If no matching merchant is found, a new one will be created.

The HTTP response code (200 OK or 201 Created) indicates whether the resource was updated or created, respectively.

merchant_id is the primary unique identifier for all Merchant APIs. Be cautious when using reference_id as a unique identifier.

Merchants must have an address or site_url set.

This endpoint is not rate limited.

Scopes: MERCHANTS_WRITE

Creates or updates a merchant based on the merchant's `reference_id`. If a merchant with a matching `reference_id` is found, it will be updated. If no matching merchant is found, a new one will be created. The HTTP response code (`200 OK` or `201 Created`) indicates whether the resource was updated or created, respectively. <Info> `merchant_id` is the primary unique identifier for all Merchant APIs. Be cautious when using `reference_id` as a unique identifier. Merchants must have an `address` or `site_url` set. </Info> **This endpoint is not rate limited.** Scopes: `MERCHANTS_WRITE`

Request

merchantobjectRequired

Details about the merchant to create or update.

Response

merchantobject

A merchant represents a depository account when processing payments from Cash App customers. Merchants do not have direct access to Cash App, so processed payments are stored in this account until they are ready for settlement.

Headers

Request

Response

Errors