BINANCE SAPI · C2C

API de Consejos y Advertencias de Riesgo

Consulta advertencias dinámicas de seguridad antifraude, notificaciones preventivas y avisos de cumplimiento regional adaptados al contexto de una orden peer-to-peer (C2C/P2P) y su ventana de chat.

ENDPOINT

POST /sapi/v1/c2c/chat/getRiskWarningTips

Autenticación USER_DATA / SIGNED

Grupo API C2C / Chat

Método POST

Respuesta JSON

Descripción General

Este endpoint entrega recomendaciones de seguridad contextuales y advertencias contra estafas basadas en el estado operativo de una orden en curso. Al enviar el identificador de la orden (orderNo), la moneda fiduciaria involucrada (fiat) y el entorno de visualización (scene), los sistemas reciben mensajes de prevención de riesgos a medida (por ejemplo, alertas sobre pagos de terceros, riesgo de contracargos bancarios o intentos de comunicación por fuera de la plataforma).

Terminales de comerciantes, consolas de mensajería y mesas de trading automatizadas invocan este endpoint al abrir la ventana de chat de una orden para mostrar alertas de seguridad en tiempo real a operadores y usuarios.

Parámetros de la Solicitud

Parámetros aceptados en el cuerpo (Body) y encabezados HTTP.

Parámetro	Ubicación	Tipo	Requerido	Descripción
`clientType`	Header	STRING	Requerido	Tipo de dispositivo o cliente que realiza la petición (por ejemplo, `WEB`, `APP` o `WEB_MOBILE`).
`orderNo`	Body	STRING	Requerido	Identificador único de la orden C2C para la cual se consultan los avisos de riesgo.
`fiat`	Body	STRING	Opcional	Símbolo de la moneda fiduciaria vinculada a la orden (por ejemplo, `USD`, `VES`, `COP`).
`scene`	Body	STRING	Opcional	Contexto de visualización de la alerta en la interfaz (por ejemplo, `CHAT`, `ORDER_DETAIL`, `RELEASE`).
`x-gray-env`	Header	STRING	Opcional	Identificador de entorno utilizado internamente para pruebas o despliegues controlados (gray testing).
`x-trace-id`	Header	STRING	Opcional	Identificador de trazabilidad generado por el cliente para el seguimiento y depuración de la solicitud.
`x-user-id`	Header	STRING	Opcional	Identificador de usuario objetivo si se requiere validar el contexto de la cuenta.

Mensajes de Seguridad Adaptados al Contexto

Definir el parámetro scene (como CHAT o RELEASE) permite que el motor de riesgo devuelva advertencias puntuales para cada etapa operativa, recordando a los vendedores no liberar fondos ante capturas de pantalla falsas o mensajes SMS simulados.

Ejemplo de Solicitud

Ejemplo de solicitud POST mediante cURL para consultar las advertencias de riesgo en el chat.

cURL BASH

curl -X POST \
'https://api.binance.com/sapi/v1/c2c/chat/getRiskWarningTips' \
-H 'clientType: WEB' \
-H 'Content-Type: application/json' \
-d '{
  "orderNo": "202608161234567890",
  "fiat": "USD",
  "scene": "CHAT"
}'

Respuesta

Ejemplo de respuesta devuelta tras una consulta exitosa.

RESPONSE 200 OK

{
    "code": "000000",
    "message": "success",
    "data": {
        "showWarning": true,
        "warningType": "THIRD_PARTY_PAYMENT",
        "title": "Evita Pagos de Terceros",
        "content": "Verifica siempre que el titular de la cuenta bancaria coincida con el nombre verificado de la contraparte. Jamás aceptes transferencias de terceros.",
        "tipsList": [
            "No te comuniques por fuera del chat oficial de Binance P2P.",
            "Comprueba el saldo real directamente en la aplicación de tu banco antes de liberar cripto."
        ]
    },
    "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.showWarning`	BOOLEAN	Indica si debe desplegarse un banner o tarjeta de advertencia en la interfaz de usuario.
`data.warningType`	STRING	Código de categoría del tipo de riesgo identificado (por ejemplo, `THIRD_PARTY_PAYMENT`, `CHARGEBACK_RISK`).
`data.title`	STRING	Título o encabezado principal de la notificación de seguridad.
`data.content`	STRING	Texto descriptivo y detallado con la explicación del aviso preventivo.
`data.tipsList`	ARRAY[STRING]	Lista de precauciones y recomendaciones operativas sugeridas para la transacción.
`success`	BOOLEAN	Indica el resultado general de la ejecución de la petición.

Cómo Funciona

Flujo de trabajo para consultar y renderizar advertencias contextuales de riesgo.

01 Orden Abierta Obtén orderNo y define scene al cargar el chat o pantalla de pago.

02 Enviar Solicitud Emite el POST con los parámetros a /getRiskWarningTips.

03 Evaluar Reglas El motor contrasta la divisa fiat, método de pago y patrones de riesgo.

04 Renderizar Banner Muestra las advertencias en la cabecera de la consola de mensajería.

Casos de Uso Comunes

Prevención de Fraude en el Chat

Despliega banners visuales destacados a los operadores cuando una contraparte inicia intercambios en pares fiduciarios de alto riesgo.

Recordatorios Previos a la Liberación

Muestra avisos indispensables de comprobación bancaria antes de habilitar los botones definitivos de entrega de activos.

Alertas de Cumplimiento Regional

Proporciona notificaciones regulatorias dinámicas según las condiciones bancarias y pasarelas de pago de cada país o moneda.