Incorporación 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.

URL base

• UAT: https://transactions.transactional.uat.unico.app/api/public/v1
• Producción: https://transactions.transactional.unico.app/api/public/v1

Importante

La Incorporación 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

Encabezado	Valor
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
}

Campo	Tipo	Requerido	Descripción
identity	object	sí	Información de identidad del usuario.
identity.key	string	sí	Tipo de clave de identificación del usuario.
identity.value	string	sí	Valor de la clave de identificación del usuario.
orderNumber	string	sí	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	string	sí	ID de la empresa responsable de la transacción, proporcionado por Unico.
redirectUrl	string	no	URL 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	object	sí	Información de la tarjeta usada en la transacción.
card.binDigits	string	sí	Primeros 8 dígitos de la tarjeta.
card.lastDigits	string	sí	Últimos 4 dígitos de la tarjeta.
card.expirationDate	string	no	Fecha de vencimiento de la tarjeta.
card.name	string	sí	Nombre del titular de la tarjeta — asegúrate de que sea correcto para evitar problemas de codificación o de aprobación.
value	number	no	Valor máximo asegurado.
additionalInfo	object	no	Envía este objeto con processID para reutilizar capturas biométricas de otros productos de la plataforma Unico IDCloud.
additionalInfo.processID	string	sí (si se envía additionalInfo)	ID del proceso de referencia de la plataforma IDCloud.

peligro

El 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..."
}

Campo	Descripció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.

Verificar estado de validación

GET /walletid/transactions/{transaction_id} — verifica el estado actual de una transacción específica.

Encabezados

Encabezado	Valor
Authorization	Bearer {token} — un token de acceso válido.

200 OK

{
  "status": "processing",
  "hasIdentityChanged": false
}

Campo	Descripción
status	Estado actual de la transacción.
hasIdentityChanged	Opcional. Indica si ocurrió un cambio de identidad en la transacción.

Consulta Enumerados 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 — Incorporación de tarjeta de crédito.