BINANCE SAPI · C2C

API para Desconectar Comerciante

Cambia la presencia operativa del comerciante al modo fuera de línea (offline), actualizando la visibilidad de su estado a lo largo de los libros de órdenes peer-to-peer (C2C/P2P).

ENDPOINT

POST /sapi/v1/c2c/merchant/getOffline

Autenticación USER_DATA / SIGNED

Grupo API C2C / Merchant

Método POST

Respuesta JSON

Descripción General

Este endpoint establece la presencia operativa de un comerciante verificado como fuera de línea (offline) en la plataforma Binance C2C (P2P). Al desconectarse, el indicador de estado en tiempo real refleja su condición de no disponible, lo que ayuda a gestionar adecuadamente las expectativas de respuesta y atención de las contrapartes que navegan por el mercado.

Sistemas de trading automatizado, aplicaciones de gestión comercial y servicios de fondo (daemons) integran este endpoint durante apagados controlados de procesos, pausas programadas o al finalizar formalmente las sesiones de atención al cliente.

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úa el contexto específico del comerciante.

Petición HTTP POST sin Cuerpo (Body)

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

Ejemplo de Solicitud

Ejemplo de solicitud POST mediante cURL para pasar el estado a fuera de línea.

cURL BASH

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

Respuesta

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

RESPONSE 200 OK

{
    "code": "000000",
    "message": "success",
    "data": null,
    "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`	NULL / VOID	Carga útil vacía devuelta cuando la desconexión se procesa correctamente.
`success`	BOOLEAN	Indica el resultado general de la ejecución de la petición.

Cómo Funciona

Flujo de trabajo para cambiar la presencia del comerciante a fuera de línea.

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

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

03 Verificar Respuesta Confirma que la respuesta retorne code: "000000".

04 Presencia Actualizada El comerciante figura como desconectado en los listados P2P.

Casos de Uso Comunes

Hooks de Apagado de Bots

Asegura que los bots de trading marquen la cuenta del comerciante como fuera de línea ante cierres de procesos o errores no controlados.

Cierre de Jornada Operativa

Cambia la presencia del comerciante a modo desconectado al finalizar el turno diario de atención.

Pausas del Operador Humano

Actualiza los indicadores de presencia cuando los operadores de soporte o traders se retiran temporalmente de sus estaciones de trabajo.