/cards/v1/cards/events

Eventos de tarjetas

Suma este endpoint en tu servicio para que podamos comunicarte las novedades de tus tarjetas en tiempo real.

Si tienes dudas sobre cómo configurar un webhook, visita nuestra documentación.

Consideraciones

Esperamos una respuesta del tipo 2XX para asegurarnos de que recibiste la notificación. Caso contrario, volveremos a enviarla.

Tipos de Eventos

  • CREATION: te notificaremos cada vez se cree una nueva tarjeta.
  • ACTIVATION: te notificaremos cada vez se active una tarjeta.
  • EMBOSSMENT: te notificaremos cada vez que enviemos a embozar una tarjeta.
  • BLOCK: te notificaremos cada vez que se bloquee una tarjeta.
  • UNBLOCK: te notificaremos cada vez que se desbloquee una tarjeta.
  • DISABLEMENT: te notificaremos cada vez que se desactive una tarjeta.

Parámetros disponibles

Header Parameters
X-Api-KeyString
X-SignatureString
X-TimestampString
X-EndpointString
Cuerpo de solicitud
application/json
event_idenum
idstring
updated_atstring
user_idstring
eventstring
card_typeenum
related_card_idstring
idempotency_keystring

Detalle de respuestas

2XX
Respuesta exitosa por parte del cliente.
4XX
Falló la respuesta. Volveremos a enviar el evento.
5XX
Falló la respuesta. Volveremos a enviar el evento.
Ejemplo de solicitud
{
  "event_id": "card-notification",
  "id": "crd-23hJL4bm94q9BFEd2sGhBjY6xbH",
  "updated_at": "2023-09-21T14:15:31.186Z",
  "user_id": "usr-23hJL4bm94q9BFEd2sGhBjY6xbH",
  "event": "ACTIVATION",
  "card_type": "VIRTUAL",
  "related_card_id": "crd-23hJL4bm94q9BFEd2sGhBjY6xbH",
  "idempotency_key": "e42c0eb9-3986-4f01-9f4a-df8d02a9a92f"
}

Pomelo AI

Asistente de inteligencia artificial para consultas sobre la API de Pomelo
¡Hola!¿Cómo puedo ayudarte hoy?
Eventos de tarjetas | Pomelo API Reference