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
Variante:
Este endpoint acepta múltiples tipos de body. Seleccioná una variante para ver sus parámetros y ejemplo.
Header Parameters
AuthorizationStringrequired
Path Parameters
idStringrequired
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/example_value?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"
]
}
}