/v1/cards/{external_card_id}/tokens

Obtener tokens por ID de tarjeta

Este endpoint permite obtener la lista de tokens asociados a una tarjeta identificada por su ID

Soporta cursor pagination bidireccional mediante los parámetros limit, start_from (paginación forward) y end_before (paginación backward).

Tambien permite filtrar los resultados mediante los parámetros opcionales filter[merchant_name], filter[token_status] y filter[token_requestor_id]. Cada filtro soporta múltiples valores (por ejemplo: filter[merchant_name]=Amazon,Walmart). Los valores del mismo filtro se combinan con OR (ej: tokens de Amazon O Walmart), mientras que diferentes filtros se combinan con AND (ej: tokens de Amazon O Walmart Y con estado ACTIVATED)

{{Los filtros aplicados se guardan automáticamente en el cursor de paginación para mantener la consistencia entre las iteraciones de páginas, asegurando que los mismos filtros se apliquen en todas las páginas subsecuentes.

Parámetros disponibles

Path Parameters
external_card_idString
Query Parameters
filter[merchant_name]String
filter[token_status]enum
filter[token_requestor_id]String
limitInteger
start_fromString
end_beforeString

Detalle de respuestas

401
No autorizado - Token inválido
403
Permiso denegado - Faltan roles necesarios

Ejemplo de código
curl -X GET "https://api.pomelo.la/v1/cards/example_value/tokens?filter[merchant_name]=example_value&filter[token_status]=OTP_PENDING&filter[token_requestor_id]=example_value&limit=50&start_from=example_value&end_before=example_value" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta (200)Respuesta exitosa con la lista de tokens asociados a la tarjeta
{
  "data": [
    {
      "external_token_id": "DSHRMC1CO0303321afa9fb0a09b54051b21325c583jdu473",
      "token_status": "ACTIVATED",
      "updated_at": "2024-01-15T10:30:00.000",
      "created_at": "2024-01-15T09:00:00.000",
      "origin": "APPLE_PAY",
      "user_id": "usr-23hJL4bm94q9BFEd2sGhBjY6xbH",
      "client_id": "client-123",
      "language": "es",
      "token_status_reason": null,
      "card_id": "crd-23hJL4bm94q9BFEd2sGhBjY6xbH",
      "from_push_provisioning": true,
      "from_tap_to_add": false,
      "token_requestor_id": "555555",
      "activated_at": "2024-01-15T10:00:00.000"
    }
  ],
  "meta": {
    "next_start_from": "eyJjYXJkX2lkIjoiY3JkLTIzaEpMNGJtOTRxOUJGZWQyc0doQmpZOXhiSCIsInNvcnRfa2V5IjoiVCN0b2tlbjUwIn0=",
    "next_end_before": "eyJjYXJkX2lkIjoiY3JkLTIzaEpMNGJtOTRxOUJGZWQyc0doQmpZOXhiSCIsInNvcnRfa2V5IjoiVCN0b2tlbjEifQ=="
  }
}

Pomelo AI

Asistente de inteligencia artificial para consultas sobre la API de Pomelo
¡Hola!¿Cómo puedo ayudarte hoy?
Obtener tokens por ID de tarjeta | Pomelo API Reference