Webhook e registro di consegna
Inoltra eventi, con firme e nuovi tentativi.
Il webhook notifica il tuo sistema esterno in tempo reale su stmpr eventi, come un nuovo ospite, un timbro, lo stato di prontezza per la ricompensa o il riscatto.
Ogni richiesta è firmata affinché il sistema ricevente possa verificare che sia stata effettivamente inviata dal stmpr. Se la consegna fallisce, il sistema ritarda il ritentativo.
Il registro di consegna mostra l'evento, l'ora, il codice di risposta e i risultati dei tentativi di ritorno.
https://stmpr.io/dashboard/developers · Webhooks
Passo dopo passo
- Vai alla pagina Webhooks nel menu Integrazioni.
- Aggiungi un endpoint HTTPS e seleziona gli eventi che vuoi inoltrare.
- Salva il segreto di firma nella configurazione sicura del sistema host.
- Invia un evento di test e verifica la firma, il corpo della richiesta e la risposta 2xx di successo.
- Dopo la trasmissione live, monitora il registro delle consegne. Al punto finale fisso, riavvia la mancata consegna.
Che cosa contiene una richiesta webhook
- Corpo della richiesta: il nome dell'evento (event), il timestamp created_at e l'oggetto data.
- data.wallet: identificativo e nome della carta fedeltà.
- data.customer: identificativo del cliente, codice a quattro cifre, timbri raccolti, timbri necessari, se il premio è pronto, oltre a iscrizione e ultima attività.
- customer.created: un cliente si è iscritto, senza campi aggiuntivi.
- stamp.added: quanto sopra più l'origine del timbro (manual, api, auto, survey_reward, kiosk).
- stamp.removed: come per l'aggiunta, con l'origine della rimozione.
- reward.ready: il cliente ha raggiunto i timbri richiesti dal premio, senza campi aggiuntivi.
- reward.redeemed: il tipo di riscatto (staff, manual, auto, api).
- pass.updated: quali carte sono state aggiornate sul telefono (apple, google).
- Intestazioni: X-Stmpr-Event porta il nome dell'evento, X-Stmpr-Delivery l'identificativo della consegna e X-Stmpr-Signature è t=timestamp,v1=HMAC-SHA256 firmato con il tuo segreto.
- Risposta: attendiamo un 2xx entro 10 secondi. In caso contrario riproviamo cinque volte in totale, dopo 10 secondi, 1 minuto, 5 minuti e 15 minuti.
Richiesta di esempio per evento
customer.created
{
"event": "customer.created",
"created_at": "2026-09-01T14:12:03+00:00",
"data": {
"wallet": {
"id": "w_8Kd2Qm",
"name": "Kávé hűségkártya"
},
"customer": {
"id": "c_9YbVt3xQ",
"display_code": "4693",
"stamps_count": 0,
"stamps_required": 10,
"ready_to_redeem": false,
"created_at": "2026-07-14T09:20:11+00:00",
"last_activity_at": "2026-09-01T14:12:03+00:00"
}
}
}stamp.added
{
"event": "stamp.added",
"created_at": "2026-09-01T14:12:03+00:00",
"data": {
"wallet": {
"id": "w_8Kd2Qm",
"name": "Kávé hűségkártya"
},
"customer": {
"id": "c_9YbVt3xQ",
"display_code": "4693",
"stamps_count": 7,
"stamps_required": 10,
"ready_to_redeem": false,
"created_at": "2026-07-14T09:20:11+00:00",
"last_activity_at": "2026-09-01T14:12:03+00:00"
},
"source": "manual"
}
}stamp.removed
{
"event": "stamp.removed",
"created_at": "2026-09-01T14:12:03+00:00",
"data": {
"wallet": {
"id": "w_8Kd2Qm",
"name": "Kávé hűségkártya"
},
"customer": {
"id": "c_9YbVt3xQ",
"display_code": "4693",
"stamps_count": 6,
"stamps_required": 10,
"ready_to_redeem": false,
"created_at": "2026-07-14T09:20:11+00:00",
"last_activity_at": "2026-09-01T14:12:03+00:00"
},
"source": "manual"
}
}reward.ready
{
"event": "reward.ready",
"created_at": "2026-09-01T14:12:03+00:00",
"data": {
"wallet": {
"id": "w_8Kd2Qm",
"name": "Kávé hűségkártya"
},
"customer": {
"id": "c_9YbVt3xQ",
"display_code": "4693",
"stamps_count": 10,
"stamps_required": 10,
"ready_to_redeem": true,
"created_at": "2026-07-14T09:20:11+00:00",
"last_activity_at": "2026-09-01T14:12:03+00:00"
}
}
}reward.redeemed
{
"event": "reward.redeemed",
"created_at": "2026-09-01T14:12:03+00:00",
"data": {
"wallet": {
"id": "w_8Kd2Qm",
"name": "Kávé hűségkártya"
},
"customer": {
"id": "c_9YbVt3xQ",
"display_code": "4693",
"stamps_count": 0,
"stamps_required": 10,
"ready_to_redeem": false,
"created_at": "2026-07-14T09:20:11+00:00",
"last_activity_at": "2026-09-01T14:12:03+00:00"
},
"type": "staff"
}
}pass.updated
{
"event": "pass.updated",
"created_at": "2026-09-01T14:12:03+00:00",
"data": {
"wallet": {
"id": "w_8Kd2Qm",
"name": "Kávé hűségkártya"
},
"customer": {
"id": "c_9YbVt3xQ",
"display_code": "4693",
"stamps_count": 7,
"stamps_required": 10,
"ready_to_redeem": false,
"created_at": "2026-07-14T09:20:11+00:00",
"last_activity_at": "2026-09-01T14:12:03+00:00"
},
"passes": [
"apple",
"google"
]
}
}