Tarjetas

Antes de empezar

• El número de la tarjeta no se guarda completo: solo se conservan las 4 últimas cifras y siempre se devuelve como **** 1234.
• Las tarjetas guardadas no se usan para cobrar: la API no tiene pasarela de pago.
• No hay tarjeta por defecto ni control de duplicados.

Listar tarjetas

GET /api/v1/ecommerce/card

No recibe parámetros.

Respuesta

{
  "success": true,
  "message": "Listado de datos mostrados de forma correcta.",
  "data": [
    { "id": 12, "number": "**** 1234", "titular": "JUAN PEREZ", "expiration_date": "08/28" }
  ]
}

Campo	Tipo	Qué es
id	entero	Identificador de la tarjeta
number	texto	Las 4 últimas cifras, enmascaradas
titular	texto	Nombre del titular
expiration_date	texto	Vencimiento en formato MM/YY

Guardar una tarjeta

POST /api/v1/ecommerce/card/register

Cuerpo

Campo	Tipo	Obligatorio	Reglas
number	texto	Sí	Solo cifras, entre 13 y 19. Sin espacios ni guiones
titular	texto	Sí	Máximo 50 caracteres
expiration_date	texto	Sí	Formato MM/YY, con mes de 01 a 12. No puede estar vencida: la tarjeta vale hasta el último día de ese mes

{
  "number": "4242424242424242",
  "titular": "JUAN PEREZ",
  "expiration_date": "12/27"
}

Respuesta

Devuelve la tarjeta guardada, ya enmascarada.

{
  "success": true,
  "message": "Tipo de documento creado de forma correcta.",
  "data": { "id": 13, "number": "**** 4242", "titular": "JUAN PEREZ", "expiration_date": "12/27" }
}

El texto de message no describe bien la operación. Para saber si salió bien, usa success y no el texto.

Si algo sale mal

HTTP	code	Cuándo	Qué hacer
422	VALIDATION_ERROR	Número con letras o espacios, fecha mal escrita o tarjeta vencida	Corrige el campo que indica errors

Editar una tarjeta

PUT /api/v1/ecommerce/card/update/{cardId}

• cardId: identificador de la tarjeta.
• El cuerpo es el mismo que al guardarla, con los tres campos obligatorios.

Devuelve la tarjeta actualizada.

Si algo sale mal

HTTP	code	Cuándo	Qué hacer
422	VALIDATION_ERROR	Algún dato no cumple las reglas	Corrige el campo que indica errors
404	CARD_NOT_FOUND	La tarjeta no existe o no es del cliente	Vuelve a listar las tarjetas

Borrar una tarjeta

DELETE /api/v1/ecommerce/card/delete/{cardId}

{ "success": true, "message": "Tarjeta eliminada de forma correcta.", "data": null }

Si algo sale mal

HTTP	code	Cuándo
404	CARD_NOT_FOUND	La tarjeta no existe o no es del cliente