Create merchant

1 curl -X POST https://api.cash.app/network/v1/merchants \ 2 -H "Accept: Accept" \ 3 -H "X-Region: X-Region" \ 4 -H "X-Signature: X-Signature" \ 5 -H "User-Agent: User-Agent" \ 6 -H "Content-Type: application/json" \ 7 -d '{ 8 "idempotency_key": "e345c3fb-1caa-46fd-b0d3-aa6c7b00ab19", 9 "merchant": { 10 "name": "merchant name", 11 "brand_id": "brand ID", 12 "country": "US", 13 "currency": "USD", 14 "category": "5432", 15 "reference_id": "reference ID", 16 "address": { 17 "country": "US", 18 "address_line_1": "1215 4th Ave", 19 "address_line_2": "Suite 2300", 20 "locality": "Seattle", 21 "postal_code": "98161-1001", 22 "administrative_district_level_1": "Washington" 23 }, 24 "site_url": "https://example.com", 25 "default_fee_plans": { 26 "in_app_fee_plan_id": "FEE_kewjsmjt35t8qhzyjeqcst5me", 27 "in_person_fee_plan_id": "FEE_kewjsmjt35t8qhzyjeqcst5me", 28 "online_fee_plan_id": "FEE_kewjsmjt35t8qhzyjeqcst5me" 29 } 30 } 31 }'

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 a new merchant. Merchants must have an address or site_url set.

This endpoint is not rate limited.

Scopes: MERCHANTS_WRITE

Request

idempotency_keystringRequired>=1 character<=64 characters

A unique identifier which can be used by Cash App to de-duplicate retries of this request, making it idempotent. Learn more about idempotency in the API.

merchantobjectRequired

Details about the merchant to create.

Response

Created

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