BINANCE SAPI · C2C

API para Cerrar Operaciones de Comerciante

Cierra o suspende temporalmente las operaciones comerciales peer-to-peer (C2C/P2P) de un comerciante verificado, pausando de inmediato sus actividades y la exposición pública de sus anuncios activos.

ENDPOINT

POST /sapi/v1/c2c/merchant/closeBusiness

Autenticación USER_DATA / SIGNED

Grupo API C2C / Merchant

Método POST

Respuesta JSON

Descripción General

Este endpoint permite a comerciantes verificados de Binance C2C (P2P) suspender temporalmente sus actividades comerciales. Al ejecutarse, el estado del perfil del comerciante cambia a cerrado o en reposo (resting), lo que oculta su perfil del mercado público y detiene la recepción de nuevas solicitudes de intercambio.

Mesas de trading automatizado y plataformas de gestión para comerciantes utilizan este endpoint como un interruptor operativo durante horarios no laborales, días festivos o ventanas de mantenimiento interno sin tener que eliminar ni modificar individualmente cada una de sus publicaciones activas.

Parámetros de la Solicitud

Parámetros de encabezado (Header) aceptados por el endpoint.

Encabezado	Tipo	Requerido	Descripción
`clientType`	STRING	Requerido	Tipo de dispositivo o cliente que realiza la consulta (por ejemplo, `WEB`, `APP` o `WEB_MOBILE`).
`x-gray-env`	STRING	Opcional	Identificador de entorno utilizado internamente para pruebas o despliegues controlados (gray testing).
`x-trace-id`	STRING	Opcional	Identificador de trazabilidad generado por el cliente para el seguimiento y depuración de la solicitud.
`x-user-id`	STRING	Opcional	Identificador de usuario objetivo si se evalúan permisos específicos de comerciante.

Petición HTTP POST sin Cuerpo (Body)

No se requiere enviar una carga útil JSON en el cuerpo de la petición. Únicamente debes especificar el encabezado obligatorio clientType dentro de las cabeceras HTTP de la solicitud.

Ejemplo de Solicitud

Ejemplo de solicitud POST mediante cURL.

cURL BASH

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

Respuesta

Ejemplo de respuesta devuelta tras la ejecución exitosa de la solicitud.

RESPONSE 200 OK

{
    "code": "000000",
    "message": "success",
    "data": true,
    "success": true
}

Campos de la Respuesta

Campo	Tipo	Descripción
`code`	STRING	Código de respuesta estándar de Binance (`"000000"` indica éxito).
`message`	STRING	Mensaje descriptivo del resultado o confirmación de la petición.
`data`	BOOLEAN	Devuelve `true` si las operaciones comerciales del comerciante se suspendieron o cerraron exitosamente.
`success`	BOOLEAN	Indica el resultado general de la ejecución de la petición.

Cómo Funciona

Flujo de trabajo para suspender temporalmente las actividades de comerciante.

01 Fijar Encabezado Incluye clientType (por ejemplo, WEB o APP) en la cabecera.

02 Emitir Solicitud Llama al endpoint /sapi/v1/c2c/merchant/closeBusiness.

03 Verificar Respuesta Confirma que el campo devuelto sea data: true.

04 Operaciones Pausadas El estado del comercio pasa a inactivo o en descanso.

Casos de Uso Comunes

Cierre Automatizado Fin de Turno

Suspende de manera programada las operaciones comerciales al culminar la jornada mediante tareas cron en tu servidor.

Protección Ante Fallas Bancarias

Detén al instante todas las actividades del comercio ante interrupciones técnicas imprevistas en tu red bancaria local.

Pausa para Rebalanceo de Liquidez

Frena la entrada de nuevas órdenes mientras transfieres fondos entre billeteras o realizas auditorías contables.