Tarjetas
La API de Cards contiene todos los endpoints necesarios para crear tarjetas nominadas e innominadas, activarlas, hacer búsquedas, obtener la información de una tarjeta en particular y más.
Funcionalidades Principales
- Creación de tarjetas nominadas: emite tarjetas físicas o virtuales asociadas a un usuario específico.
- Creación de tarjetas innominadas: crea lotes de hasta 1.000 tarjetas sin usuario asignado. Estarán disponibles para cuando las necesites.
- Ciclo de vida completo: activa, bloquea, desbloquea y deshabilita tarjetas.
- Búsqueda y filtrado: consulta tarjetas con múltiples filtros, ordenamiento y paginación.
- Datos sensibles: accede de forma segura al PAN, CVV, PIN y fecha de vencimiento con certificación PCI DSS.
- CVV dinámico: refresca el código de seguridad de tarjetas virtuales en tiempo real.
- Condiciones de uso: habilita o deshabilita los canales en los que podrá operar cada tarjeta (e-commerce, cajeros automáticos, entre otros).
- Webhooks: recibe notificaciones en tiempo real sobre los cambios de estado de las tarjetas.
Acceso a datos sensibles
Para consultar algunos datos de la tarjeta (PAN, CVV, PIN, vencimiento) necesitas certificación PCI DSS y documentación AOC vigente.
Consideraciones
- El parámetro
extenden/v1/{cardPid}permite acceder a datos sensibles. - Sin certificación PCI DSS activa, la respuesta será 403 Forbidden.
- Los datos seguros nunca se almacenan en texto plano. Se gestionan a través del HSM.
ENDPOINTS
POST-Crear TarjetaGET-Obtener TarjetaGET-Buscar TarjetasPATCH-Actualizar TarjetaPOST-Activar TarjetaPATCH-Actualizar Servicios de TarjetaPOST-Refrescar CVV de TarjetaPOST-Crear Lote de Tarjetas InnominadasPOST-Crear Múltiples Lotes de InnominadasPUT-Actualizar Envío de un lote de tarjetasGET-Obtener Grupo de AfinidadPOST-Crear Multi-TarjetaPUT-Actualizar Envío de TarjetaPOST-Crear Lote de Multi-Tarjetas
WEBHOOKS