BINANCE SAPI · C2C

API para Verificar si Puede Liberar Activo Digital

Valida previamente los códigos de autenticación de dos factores (2FA) y los requisitos de autorización del vendedor antes de liberar las criptomonedas en custodia (escrow) hacia el comprador.

ENDPOINT

POST /sapi/v1/c2c/orderMatch/checkIfCanReleaseCoin

Autenticación USER_DATA / SIGNED

Grupo API C2C / Order Match

Método POST

Respuesta JSON

Descripción General

Este endpoint permite al vendedor o a un bot automatizado de liquidación verificar previamente las credenciales de autenticación multifactor (MFA/2FA) requeridas para liberar criptomonedas retenidas en el depósito de garantía (escrow) de Binance. Comprueba si los parámetros de seguridad (como Google Authenticator, SMS, correo electrónico OTP, llaves de paso FIDO2 o tokens YubiKey) son válidos para la orden en cuestión antes de ejecutar la transferencia definitiva de fondos.

Integrar esta comprobación previa en los flujos de liberación automática garantiza que las credenciales de seguridad sean correctas antes de disparar la transacción irreversible de entrega de los activos.

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` o `APP`).
`orderNumber`	Body	STRING	Requerido	Identificador único de la orden C2C cuya liberación se desea evaluar.
`authType`	Body	STRING	Opcional	Mecanismo de autenticación utilizado (por ejemplo, `FIDO2`, `GOOGLE`, `SMS`, `EMAIL` o `YUBIKEY`).
`code`	Body	STRING	Opcional	Código de verificación genérico en formato texto.
`confirmPaidType`	Body	STRING	Opcional	Identificador del tipo de confirmación de pago recibido.
`googleVerifyCode`	Body	STRING	Opcional	Código TOTP de 6 dígitos de Google Authenticator.
`mobileVerifyCode`	Body	STRING	Opcional	Código de verificación recibido por mensaje de texto SMS.
`emailVerifyCode`	Body	STRING	Opcional	Código de verificación enviado al correo electrónico registrado en la cuenta.
`yubikeyVerifyCode`	Body	STRING	Opcional	Token OTP o firma criptográfica generado por la llave de seguridad física YubiKey.
`payId`	Body	LONG	Opcional	Identificador de configuración del método de pago seleccionado por el vendedor.
`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.

Liberación Irreversible del Depósito en Garantía

Liberar activos digitales de la custodia de Binance es una operación irreversible. Solo avanza hacia el paso de liberación final cuando hayas comprobado de forma independiente en tu banco o billetera la recepción íntegra del dinero fiat.

Ejemplo de Solicitud

Ejemplo de solicitud POST mediante cURL para validar el código 2FA de Google Authenticator.

cURL BASH

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

Respuesta

Ejemplo de respuesta devuelta tras una comprobación exitosa.

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 la validación de liberación es correcta; devuelve `false` en caso contrario.
`success`	BOOLEAN	Indica el resultado general de la ejecución de la petición.

Cómo Funciona

Flujo de trabajo para validar los permisos de liberación de criptoactivos.

01 Capturar 2FA Recibe el código TOTP, SMS, correo o llave FIDO2 del vendedor.

02 Enviar Validación Emite el POST con las credenciales a /checkIfCanReleaseCoin.

03 Evaluar Respuesta Comprueba que la respuesta retorne data: true.

04 Ejecutar Liberación Llama al endpoint final de liberación para transferir la criptomoneda.

Casos de Uso Comunes

Pre-Validación de Códigos 2FA

Verifica códigos de Google Authenticator o SMS antes de ejecutar la llamada irreversible de liberación de fondos en custodia.

Salvaguardas en Bots de Liquidación

Garantiza que los bots de trading confirmen las credenciales de seguridad antes de intentar la entrega programada de los activos.

Gestión de Errores en la Interfaz

Muestra retroalimentación visual inmediata en paneles de comerciante si el código 2FA ingresado es incorrecto o ya expiró.