BINANCE SAPI · C2C

Merchant Close Business API

Temporarily close or suspend peer-to-peer (C2C) merchant business operations, pausing merchant activities and active advertisement exposure.

ENDPOINT
POST /sapi/v1/c2c/merchant/closeBusiness
Authentication USER_DATA / SIGNED
API Group C2C / Merchant
Method POST
Response JSON

Overview

This endpoint allows verified Binance C2C (P2P) merchants to temporarily close their business operations. When executed, the merchant profile status is set to closed/resting, which pauses public merchant visibility and halts inbound trade requests.

Automated trading desks and merchant systems use this endpoint as an operational toggle during non-business hours, holidays, or maintenance routines without needing to delete individual advertisement listings.

01

Request Parameters

Header parameters accepted by the endpoint.

Header Type Required Description
clientType STRING Required Client Device Type initiating the request (e.g., WEB, APP, WEB_MOBILE).
x-gray-env STRING Optional Environment flag identifier used for internal gray/stage testing.
x-trace-id STRING Optional Custom client trace ID for request lifecycle tracking and debugging.
x-user-id STRING Optional Target user identifier for merchant permission checks.
i
HTTP POST with Empty Body

No JSON payload body is required for this operation. Simply provide the mandatory clientType inside the HTTP Request Headers.

02

Request Example

Example POST request using cURL.

cURL BASH
curl -X POST \
'https://api.binance.com/sapi/v1/c2c/merchant/closeBusiness' \
-H 'clientType: WEB'
03

Response

Example response returned on successful request execution.

RESPONSE 200 OK
{
    "code": "000000",
    "message": "success",
    "data": true,
    "success": true
}

Response Fields

Field Type Description
code STRING Standard Binance status response code ("000000" indicates success).
message STRING Status description or response feedback message.
data BOOLEAN Returns true if the merchant business operations were successfully closed/suspended.
success BOOLEAN Indicates overall request execution result.
04

How It Works

Workflow for closing merchant operations.

01 Set Headers Pass clientType (e.g. WEB or APP) in HTTP header.
02 Send POST Request Call /sapi/v1/c2c/merchant/closeBusiness endpoint.
03 Verify Status Confirm response returns data: true.
04 Operations Paused Merchant store status changes to offline/resting.

Common Use Cases

Automated End-of-Day Shutdown

Automatically suspend merchant trading at the end of active operating shifts via cron schedules.

Emergency Outage Protection

Instantly halt merchant operations during local banking downtime or payment network disruptions.

Inventory Restocking

Temporarily close incoming orders while rebalancing liquidity or performing accounting audits.



💬
Telegram WhatsApp