BINANCE SAPI · C2C

API para Obtener URL Prefirmada de Imagen en Chat

Genera una URL prefirmada temporal y una clave de almacenamiento autorizada para cargar comprobantes de pago, capturas de transferencias e imágenes de verificación directamente en el almacenamiento de Binance C2C.

ENDPOINT

POST /sapi/v1/c2c/chat/image/pre-signed-url

Autenticación USER_DATA / SIGNED

Grupo API C2C / Chat

Método POST

Respuesta JSON

Descripción General

Este endpoint permite a bots de trading, herramientas de atención al cliente y webhooks de comerciantes solicitar una URL prefirmada temporal para transferir archivos de imagen directamente al almacenamiento en la nube de Binance C2C (P2P). Al especificar el nombre de archivo deseado (imageName), el servicio devuelve una dirección de subida firmada de almacenamiento en objetos (S3) junto con los identificadores de recurso resultantes.

Una vez que el cliente carga el archivo binario de la imagen (como un recibo de transferencia bancaria o captura de pago) hacia la URL prefirmada mediante una petición HTTP PUT, la URL o clave generada (imageKey) puede compartirse en la conversación del chat de la orden P2P. Para automatizar este flujo por completo, revisa nuestro tutorial paso a paso sobre envío de comprobantes de pago al chat de Binance P2P mediante Python y WebSocket.

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`).
`imageName`	Body	STRING	Requerido	Nombre original del archivo de imagen con su extensión (por ejemplo, `comprobante_pago.jpg`, `recibo_123.png`).
`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 evaluar el contexto de la cuenta.

Flujo de Carga Binaria Directa

La URL devuelta en preSignedUrl tiene una vigencia temporal limitada. Sube el contenido binario de la imagen enviando directamente una petición HTTP PUT hacia esa dirección antes de que expire el enlace prefirmado.

Ejemplo de Solicitud

Ejemplo de solicitud POST mediante cURL para generar una URL prefirmada de carga de imagen.

cURL BASH

curl -X POST \
'https://api.binance.com/sapi/v1/c2c/chat/image/pre-signed-url' \
-H 'clientType: WEB' \
-H 'Content-Type: application/json' \
-d '{
  "imageName": "comprobante_transferencia.jpg"
}'

Respuesta

Ejemplo de respuesta devuelta tras la generación exitosa del enlace prefirmado.

RESPONSE 200 OK

{
    "code": "000000",
    "message": "success",
    "data": {
        "preSignedUrl": "https://binance-c2c-upload.s3.amazonaws.com/chat/2026/08/17/img_987654321.jpg?AWSAccessKeyId=...",
        "imageUrl": "https://binance-c2c.s3.amazonaws.com/chat/2026/08/17/img_987654321.jpg",
        "imageKey": "chat/2026/08/17/img_987654321.jpg"
    },
    "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.preSignedUrl`	STRING	Endpoint temporal autorizado donde debe enviarse el archivo binario mediante una petición HTTP PUT.
`data.imageUrl`	STRING	URL pública accesible de la imagen en la CDN o almacenamiento de Binance para adjuntar en mensajes de chat C2C.
`data.imageKey`	STRING	Clave de objeto en el almacenamiento interno de Binance que identifica al recurso de imagen subido.
`success`	BOOLEAN	Indica el resultado general de la ejecución de la petición.

Cómo Funciona

Flujo de trabajo para cargar y enviar imágenes en el chat de Binance P2P.

01 Solicitar URL Envía el imageName en POST hacia /image/pre-signed-url.

02 Cargar Binario Emite un HTTP PUT con los bytes de la imagen hacia preSignedUrl.

03 Obtener Recurso Usa data.imageUrl o imageKey como identificador del archivo cargado.

04 Enviar en Chat Publica el mensaje con el comprobante en la conversación de la orden.

Casos de Uso Comunes

Envío Automatizado de Comprobantes de Pago

Sube y envía comprobantes de transferencia bancaria en formato JPG o PNG directamente al chat de la orden tan pronto se liquida la moneda fiat.

Documentación de KYC y Validación de Identidad

Transfiere archivos y documentos de verificación de identidad de forma segura durante revisiones operativas o resolución de disputas.

Módulos de Carga en Paneles de Operador

Integra áreas de arrastrar y soltar (drag-and-drop) para adjuntar capturas de pago en aplicaciones de escritorio y consolas de comerciantes.