EVENT
/tokenization/token-notificationNotificación de aprovisionamiento de tokens
Esta notificación webhook se envía para comunicar eventos relacionados al flujo de aprovisionamiento de tokens.
El evento se dispara cuando ocurre una situación del proceso de tokenización para la que el cliente configuró la recepción de notificaciones.
¿Cuándo se envía este webhook?
Actualmente, este webhook se envía cuando una tokenización no se completó y permanece pendiente de verificación por parte del usuario.
El evento se identifica mediante event_id: tokenization-abandoned-notification.
Nuevos tipos de notificación pueden ser agregados en el futuro.
Información contenida en el evento
El webhook contiene la siguiente información:
- Información del token: ID de la tarjeta, ID del usuario, ID externo del token y origen de la tokenización
- Identificador del evento: el valor de
event_idque indica el evento de aprovisionamiento que motivó la notificación - Clave de idempotencia: el identificador único para reconocer reintentos del mismo evento
Manejo del evento
Tu sistema debe:
- Validar la firma utilizando los headers
X-Signature,X-Timestamp,X-EndpointyX-Api-Key. - Procesar la notificación según el valor de
event_id. - Deduplicar reintentos utilizando el campo
idempotency_key. - Devolver un código 2XX para confirmar la recepción correcta.
- Cualquier respuesta 4XX o 5XX disparará reintentos por parte de Pomelo.
Parámetros disponibles
Header Parameters
X-Api-KeyStringrequired
X-SignatureStringrequired
X-TimestampStringrequired
X-EndpointStringrequired
Cuerpo de solicitud
application/jsonevent_idenumrequired
card_idstringrequired
user_idstringrequired
token_external_idstringrequired
originenumrequired
idempotency_keystringrequired
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": "tokenization-abandoned-notification",
"card_id": "crd-23hJL4bm94q9BFEd2sGhBjY6xbH",
"user_id": "usr-23hJL4bm94q9BFEd2sGhBjY6xbH",
"token_external_id": "token_ext_123456789",
"origin": "APPLE_PAY",
"idempotency_key": "123e4567-e89b-12d3-a456-426614174000"
}