GET
/cards/v1/{id}Obtener Tarjeta
El endpoint /cards/v1/{id} te permite obtener información sobre una tarjeta en particular.
Consideraciones
- Si contrataste CVV dinámico, verás el campo cvv_expiration_time que determina la validez del nuevo código. Saber más sobre CVV dinámico.
⚠️ Acceso a datos sensibles mediante el parámetro extend
Esta funcionalidad permite acceder a datos sensibles de tarjeta como el número completo (PAN), código de seguridad (CVV), nombre del titular y fecha de expiración.
Por requerimiento del estándar PCI DSS, únicamente podrás usar esta funcionalidad si:
- Cuentas con certificación PCI DSS vigente que contemple el tratamiento y almacenamiento de datos de tarjeta.
- Nos compartes por mail tu Attestation of Compliance (AOC) como prueba formal del cumplimiento.
Si no cumples estos requisitos, podrás utilizar nuestra Web de data segura.
Parámetros disponibles
Header Parameters
AuthorizationStringrequired
Query Parameters
extendenum
Detalle de respuestas
401
No autorizado
403
Acceso denegado
Ejemplo de código
curl -X GET "https://api.pomelo.la/cards/v1/{id}?extend=pan" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY"Ejemplo de respuesta (200)OK
{
"data": {
"id": "crd-20gRqyp809SvDzXzhSeG2w6UiO5",
"affinity_group_id": "afg-20MpN8vmIPj77ujhb9cS8ctstN2",
"card_type": "VIRTUAL",
"product_type": "PREPAID",
"status": "ACTIVE",
"status_detail": "CLIENT_INTERNAL_REASON",
"shipment_id": "shi-2VOLbX1fAeWAn1rABlorxBqRyGF",
"user_id": "usr-5BERfwA0nyGFI4Wn8a5y3yv3IGW",
"start_date": "2021-11-08",
"last_four": "1573",
"provider": "MASTERCARD",
"affinity_group_name": "VIRTUAL_TEST",
"company": "Pomelo",
"name_on_card": "Dieguito",
"parent_id": "crd-20gRqyp809SvDzXzhSeG2w6UiO5",
"activated_at": "2021-11-18"
},
"meta": {
"extend": [
"string"
]
}
}