--- title: Transacciones de pago description: Referencia de la API REST para crear transacciones de pago, verificar el estado, recuperar evidencia y reenviar notificaciones en Verificación de Tarjeta No Presente. canonical: https://developer.unico.io/es/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference/payment-transactions locale: es generated_by: markdown-export --- - [/es/](/es/) - Soluciones Regionales - [Verificación de Tarjeta No Presente](/es/dual-api/developers/regional-solutions/card-not-present-verification) - [Integración](/es/dual-api/developers/regional-solutions/card-not-present-verification/integration/overview) - [APIs](/es/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis) - [Referencia de API](/es/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference) - Transacciones de pago **En esta página# Transacciones de pago ### Antes de empezar​ Tus solicitudes a la API se autentican mediante un token de acceso. Cualquier solicitud que no incluya un token de acceso válido devolverá un error. Obtén más información en [Autenticación](/es/developers/regional-solutions/card-not-present-verification/integration/authentication). URL base **UAT**: `https://transactions.transactional.uat.unico.app/api/public/v1` **Producción**: `https://transactions.transactional.unico.app/api/public/v1` ### Crear transacción​ `POST /credit/transaction` — crea una nueva transacción. peligroPara garantizar una mejor conversión, crea la transacción **solo después** de completar cualquier preautenticación o validación que pudiera finalizar la operación antes de la experiencia de Verificación de Tarjeta No Presente. peligroEl campo `orderNumber` debe completarse con el número de pedido **único** de esa compra en el sistema de e-commerce — usar un ID transaccional distinto es incorrecto. Reutilizarlo puede causar baja conversión (el número de pedido ayuda al usuario final a completar el flujo) y errores de la API como `replicated transaction` si se usan el mismo número de pedido, CPF, BIN y últimos 4 dígitos. Encabezados EncabezadoValor`Authorization``Bearer {token}` — un token de acceso válido. Cuerpo ``` { "identity": { "key": "cpf", "value": "12345678900" }, "orderNumber": "order-98765", "company": "company-id", "redirectUrl": "https://yourapp.com/checkout/return", "card": { "binDigits": "12345678", "lastDigits": "1234", "expirationDate": "12/2028", "name": "John Doe" }, "value": 199.90, "mainContacts": [ { "key": "phone", "value": "5543999999999" } ], "additionalInfo": { "externalUserID": "YOUR_EXTERNAL_USER_ID" }} ``` CampoTipoRequeridoDescripción`identity`objectsíDatos de identificación del usuario.`identity.key`stringsíTipo de clave de identificación del usuario. Se recomienda `cpf` — mayor tasa de conversión.`identity.value`stringsíValor de la clave de identificación del usuario, sin puntos ni guiones.`orderNumber`stringsíNúmero de pedido asociado con la transacción. Se usa como índice en el portal y como clave foránea entre tu sistema y Verificación de Tarjeta No Presente.`company`stringsíID de la empresa responsable de la transacción, proporcionado por Unico.`redirectUrl`stringnoURL para redirigir al usuario después de completar la transacción (una URL HTTPS para web, o un esquema de URL para apps móviles nativas).`card`objectsíInformación sobre la tarjeta usada en la transacción.`card.binDigits`stringsíPrimeros 8 dígitos de la tarjeta.`card.lastDigits`stringsíÚltimos 4 dígitos de la tarjeta.`card.expirationDate`stringnoFecha de vencimiento de la tarjeta.`card.name`stringsíNombre del titular de la tarjeta. Envíalo correctamente, evitando problemas de codificación — este dato se usa en la experiencia de usuario y en la comunicación.`value`numbersíValor total de la compra.`mainContacts`arraynoLista de contactos principales (correos electrónicos y/o teléfonos) usados para notificar al usuario, cuando Verificación de Tarjeta No Presente es responsable de la notificación.`fallbackContacts`arraynoLista de contactos de respaldo, activados si los intentos de notificación de los contactos principales fallan.`additionalInfo`objectnoEnvía este objeto con `externalUserID` para habilitar [Verificación silenciosa](/es/developers/regional-solutions/card-not-present-verification/integration/silent-verification) para esta transacción.`additionalInfo.externalUserID`stringsí (si se envía `additionalInfo`)El mismo identificador configurado mediante el `externalUserId` del SDK al recopilar los metadatos del dispositivo. Necesario para activar la validación silenciosa — sin él, la transacción se crea normalmente pero siempre sigue el flujo visual estándar. 200 OK ``` { "id": "6ab1771e-dfab-4e47-8316-2452268e5481", "status": "processing", "link": "https://developers/regional-solutions/card-not-present-verification.unico.app/t/6ab1771e-dfab-4e47-8316-2452268e5481", "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...", "expiresAt": "2026-07-22T15:30:00Z"} ``` CampoDescripción`id`ID de la transacción creada.`status`Estado actual de la transacción.`link`Enlace relacionado con la transacción.`token`Token firmado que contiene los parámetros necesarios para inicializar el SDK web de Verificación de Tarjeta No Presente.`expiresAt`Fecha y hora de expiración de la transacción, ISO 8601 (UTC). advertenciaSi las validaciones determinan que no se requiere captura biométrica, la respuesta tiene un estado diferente y no se genera un enlace de captura:``` { "id": "6ab1771e-dfab-4e47-8316-2452268e5481", "status": "fast-inconclusive"} ``` Esto ocurre cuando se usan los módulos Pre o Super Pre para Checkout, según [Feature](/es/developers/regional-solutions/card-not-present-verification/about-idpay/feature). notaSi se envió `additionalInfo.externalUserID` y la transacción se aprueba silenciosamente, la respuesta también omite el enlace de captura:``` { "id": "6ab1771e-dfab-4e47-8316-2452268e5481", "status": "approved"} ``` Consulta [Verificación silenciosa](/es/developers/regional-solutions/card-not-present-verification/integration/silent-verification) para conocer el flujo completo, incluida la configuración del SDK y los requisitos de tiempo. Para respuestas de error, consulta [Errores — Creación de transacción](/es/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/errors#creaci%C3%B3n-de-transacci%C3%B3n). ### Obtener estado de la transacción​ `GET /credit/transactions/{transaction_id}` — verifica el estado actual de una transacción específica. Encabezados EncabezadoValor`Authorization``Bearer {token}` — un token de acceso válido. 200 OK ``` { "status": "processing"} ``` CampoDescripción`status`Estado actual de la transacción. Consulta [Enumerados](/es/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/enumerated) para ver todos los estados posibles. Para optimizar el rendimiento, implementa el Webhook en lugar de hacer polling a este endpoint. Para respuestas de error, consulta [Errores — Obtener el estado de la transacción](/es/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/errors#obtener-el-estado-de-la-transacci%C3%B3n). ### Obtener conjunto probatorio de la transacción​ `GET /credit/transactions/{transaction_id}/probative` — recupera el conjunto probatorio de una transacción específica. advertenciaEl conjunto probatorio solo se puede generar para transacciones **aprobadas**. peligroEl enlace devuelto para el conjunto probatorio es válido durante **cinco minutos** después de obtenerlo — no lo guardes, úsalo para descargar el conjunto probatorio inmediatamente. Encabezados EncabezadoValor`Authorization``Bearer {token}` — un token de acceso válido. 200 OK ``` { "link": "https://unico.io/probative.pdf"} ``` CampoDescripción`link`URL del archivo probatorio. Para respuestas de error, consulta [Errores — Recuperación del conjunto probatorio de la transacción](/es/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/errors#recuperaci%C3%B3n-del-conjunto-probatorio-de-la-transacci%C3%B3n). ### Reenviar notificación de la transacción​ `POST /credit/transactions/{transaction_id}/notify` — reenvía notificaciones por correo electrónico y/o teléfono para una transacción específica. notaTambién es posible configurar el reenvío de notificaciones a través del portal, sin implementarlo mediante la API. Habla con el punto de contacto de tu proyecto para conocer las posibilidades. Encabezados EncabezadoValor`Authorization``Bearer {token}` — un token de acceso válido. Cuerpo ``` { "phone": "NOTIFICATION_PHONE", "email": "NOTIFICATION_EMAIL"} ``` CampoTipoRequeridoDescripción`phone`stringsíNúmero de teléfono al que enviar la notificación.`email`stringsíDirección de correo electrónico a la que enviar la notificación. 200 OK ``` { "id": "b50ee24c-71eb-4a5d-ade1-41c48b44c240", "link": "https://aces.so/example"} ``` CampoDescripción`id`ID único de la notificación generada.`link`Enlace generado para la notificación. Para respuestas de error, consulta [Errores — Reenvío de la notificación de la transacción](/es/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/errors#reenv%C3%ADo-de-la-notificaci%C3%B3n-de-la-transacci%C3%B3n).Última actualización el 8 oct 2026**