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.
El endpoint /cards/v1/
permite crear una nueva tarjeta nominada que puede ser física o virtual.
Validaremos que cumplas los requisitos que detallamos en la (documentación)[https://docs.pomelo.la/docs/cards/issuing/cards#3-crear-tarjetas].
El endpoint /cards/v1/
te permite buscar un grupo de tarjetas según los atributos que especifiques.
Podrás filtrar y ordenar las tarjetas siguiendo esta documentación.
Los atributos para ordenar son:
card_type
user_id
status
affinity_group_id
status_detail
shipment_id
innominate
start_date
.El endpoint /cards/v1/{id}
te permite obtener información sobre una tarjeta en particular.
extend
se usa para obtener datos adicionales de una tarjeta y para usarlo deberás contar con una certificación PCI-DSS válida y vigente, respaldada por el reporte ROC. Si no tienes la certificación, sigue los pasos de esta documentación.El endpoint /cards/v1/{id}
te permite actualizar el estado de una tarjeta, su grupo de afinidad y el PIN.
Deberás especificar una razón del siguiente listado para poder actualizar el estado de una tarjeta:
Nuevo estado | Razón válida |
---|---|
BLOCKED / DISABLED | CLIENT_INTERNAL_REASON |
BLOCKED / DISABLED | USER_INTERNAL_REASON |
DISABLED | LOST |
DISABLED | STOLEN |
DISABLED | BROKEN |
DISABLED | UPGRADE |
El endpoint /cards/v1/activation
te permite activar una tarjeta física y también configurar un PIN.
Validaremos que cumplas los requisitos que detallamos en la (documentación)[https://docs.pomelo.la/docs/cards/issuing/cards#4-activar-tarjeta].
El endpoint /cards/v1/{id}/shipment
te permite actualizar el domicilio de envío de una tarjeta.
La tarjeta deberá ser física nominada y tener estado CREATED
.
El endpoint /cards/v1/batches
te permite crear un lote de tarjetas innominadas.
Validaremos que cumplas los requisitos que detallamos en la (documentación)[https://docs.pomelo.la/docs/cards/issuing/cards].
CLIENT
.El endpoint /cards/v1/batches/bulk
te permite crear hasta 15 lotes de tarjetas innominadas al mismo tiempo.
Validaremos que cumplas los requisitos que detallamos en la (documentación)[https://docs.pomelo.la/docs/cards/issuing/cards].
CLIENT
.El endpoint /cards/v1/batches/shipments/{shipmentId}
te permite actualizar el domicilio de envío de un lote de tarjetas.
El lote de tarjetas deberá ser física innominada y tener estado CREATED
.
/config/affinity-groups/{id}
te permite obtener información sobre un grupo de afinidad en particular.