--- title: Onboarding de tarjeta de crédito description: Referencia de la API REST para validar una tarjeta de crédito y verificar el estado de validación en la funcionalidad de Onboarding de tarjeta de crédito de 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/credit-card-onboarding 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) - Onboarding de tarjeta de crédito **En esta página# Onboarding de tarjeta de crédito ### 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` ImportanteEl Onboarding de tarjeta de crédito se puede realizar solicitando una selfie al usuario final y completando el registro completo, **o** reutilizando capturas biométricas de procesos ejecutados por otros productos de la plataforma Unico IDCloud: Para reutilizar procesos generados por otros productos de IDCloud, proporciona el ID del proceso de referencia en `additionalInfo.processID`; El proceso de referencia usado debe haberse completado no más de **1 hora** antes. ### Validar tarjeta de crédito​ `POST /walletid/transaction` — valida una tarjeta de crédito. Encabezados EncabezadoValor`Authorization``Bearer {token}` — un token de acceso válido. Cuerpo ``` { "identity": { "key": "cpf", "value": "12345678900" }, "orderNumber": "onboarding-98765", "company": "company-id", "redirectUrl": "https://yourapp.com/wallet/return", "card": { "binDigits": "12345678", "lastDigits": "1234", "expirationDate": "12/2028", "name": "John Doe" }, "value": 5000.00, "additionalInfo": { "externalUserID": "YOUR_EXTERNAL_USER_ID" }} ``` CampoTipoRequeridoDescripción`identity`objectsíInformación de identidad del usuario.`identity.key`stringsíTipo de clave de identificación del usuario.`identity.value`stringsíValor de la clave de identificación del usuario.`orderNumber`stringsíNúmero asociado con la incorporació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 una URL de esquema para apps móviles nativas).`card`objectsíInformación de 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 — asegúrate de que sea correcto para evitar problemas de codificación o de aprobación.`value`numbernoValor máximo asegurado.`additionalInfo`objectnoEnvía este objeto con `processID` para reutilizar capturas biométricas de otros productos de la plataforma Unico IDCloud, y/o con `externalUserID` para habilitar la [Verificación Silenciosa](/es/developers/regional-solutions/card-not-present-verification/integration/silent-verification) para esta transacción.`additionalInfo.processID`stringnoID del proceso de referencia de la plataforma IDCloud.`additionalInfo.externalUserID`stringnoEl mismo identificador configurado a través del `externalUserId` del SDK al recopilar los metadatos del dispositivo. Requerido solo para activar la validación silenciosa — sin él, la transacción se crea normalmente pero siempre sigue el flujo visual estándar. 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, y reutilizar valores puede provocar errores de `replicated transaction`. 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..."} ``` CampoDescripción`id`ID de la transacción creada.`status`Estado actual de la transacción.`link`Enlace relacionado con la transacción. Solo se devuelve si **no** se proporciona `additionalInfo.processID`.`token`Token firmado para inicializar el SDK web de Verificación de Tarjeta No Presente. Solo se devuelve si **no** se proporciona `additionalInfo.processID`. 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, incluyendo la configuración del SDK y los requisitos de tiempo. ### Verificar estado de validación​ `GET /walletid/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", "hasIdentityChanged": false} ``` CampoDescripción`status`Estado actual de la transacción.`hasIdentityChanged`Opcional. Indica si ocurrió un cambio de identidad en 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 — Onboarding de tarjeta de crédito](/es/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/errors#credit-card-onboarding).Última actualización el 8 oct 2026**