BINANCE SAPI · C2C

API de Verificación de KYC Adicional

Verifica las credenciales suplementarias de KYC (Conozca a su Cliente), los niveles de comprobación de identidad y el cumplimiento normativo de la contraparte vinculada a una orden peer-to-peer (C2C/P2P).

ENDPOINT

POST /sapi/v1/c2c/orderMatch/verifiedAdditionalKyc

Autenticación USER_DATA / SIGNED

Grupo API C2C / Order Match

Método POST

Respuesta JSON

Descripción General

Este endpoint permite a comerciantes verificados y escritorios institucionales de alto volumen en Binance C2C (P2P) confirmar si la contraparte ha cumplido con los requisitos complementarios de verificación de identidad (KYC) en una orden en curso. Comprueba acreditaciones personalizadas, certificaciones de niveles superiores y verificaciones antifraude asociadas a la transacción.

Plataformas automatizadas de cumplimiento normativo y motores de prevención de riesgo integran este endpoint para asegurar que las contrapartes satisfagan las regulaciones financieras locales antes de recibir, procesar o transferir fondos fiduciarios.

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`).
`orderNumber`	Body	STRING	Requerido	Número de identificación único de la orden C2C para verificar el estado de KYC adicional.
`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.

Automatización de Cumplimiento

Utiliza este chequeo previo para contrastar automáticamente a las contrapartes contra tus listas blancas de cumplimiento antes de emitir transferencias bancarias o procesar depósitos fiat de alto monto.

Ejemplo de Solicitud

Ejemplo de solicitud POST mediante cURL para validar el KYC adicional de una orden.

cURL BASH

curl -X POST \
'https://api.binance.com/sapi/v1/c2c/orderMatch/verifiedAdditionalKyc' \
-H 'clientType: WEB' \
-H 'Content-Type: application/json' \
-d '{
  "orderNumber": "202608161234567890"
}'

Respuesta

Ejemplo de respuesta devuelta tras una validación exitosa.

RESPONSE 200 OK

{
    "code": "000000",
    "message": "success",
    "data": {
        "orderNumber": "202608161234567890",
        "verified": true,
        "kycLevel": "VERIFIED_PLUS",
        "realName": "John Doe",
        "country": "US"
    },
    "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.orderNumber`	STRING	Identificador único de la orden C2C evaluada.
`data.verified`	BOOLEAN	Indica si la contraparte ha cumplido los requisitos complementarios de KYC (`true` o `false`).
`data.kycLevel`	STRING	Nivel de verificación de identidad alcanzado por la contraparte (por ejemplo, `VERIFIED`, `VERIFIED_PLUS` o `ENTERPRISE`).
`data.realName`	STRING	Nombre legal completo verificado en los documentos de identidad del titular.
`data.country`	STRING	Código de país o jurisdicción oficial de la contraparte verificada.
`success`	BOOLEAN	Indica el resultado general de la ejecución de la petición.

Cómo Funciona

Flujo de trabajo para validar los requisitos de KYC adicional de la contraparte.

01 Emparejamiento Obtén el orderNumber a partir del evento de creación de la orden.

02 Enviar Solicitud Emite el POST con orderNumber a /verifiedAdditionalKyc.

03 Evaluar Cumplimiento Verifica nombre real, nivel de identidad y país de registro.

04 Avanzar o Retener Autoriza la transacción o deriva la orden a revisión del operador.

Casos de Uso Comunes

Prevención de Pagos a Terceros

Comprueba que el nombre legal verificado en realName coincida de forma exacta con el titular de la cuenta bancaria para evitar triangulaciones fraudulentas.

Cumplimiento Jurisdiccional y AML

Inspecciona el país de residencia de la contraparte para garantizar la aplicación estricta de normas locales contra el blanqueo de capitales.

Autorización por Niveles de Identidad

Exige niveles avanzados como VERIFIED_PLUS antes de ejecutar órdenes institucionales o de volumen elevado en mesas P2P.