Συμβάντα · Επαλήθευση
verification.requested
Ζητήθηκε επαλήθευση
Ζητήθηκε από τους επαληθευτές να ελέγξουν μια κάρτα: κάποιος ζήτησε έλεγχο ή ορίστηκαν νέοι επαληθευτές (data.reason: requested | new_verifier).
- Τύπος αντικειμένου
- card
- Παραλήπτες
- Τα webhooks που βλέπουν το αντικείμενο: ανάλογα με τον ρόλο, το προφίλ δεδομένων και τις συλλογές
Σώμα παράδοσης
Αντικείμενο: EventVerificationRequested
idstringυποχρεωτικόID του συμβάντος (
evt_…), που στέλνεται επίσης ως κεφαλίδαwebhook-id. Χρησιμοποιήστε το για να απορρίπτετε διπλές παραδόσεις.typestringυποχρεωτικόΕπιτρεπόμενες τιμές:
verification.requestedcreated_atstring (date-time)υποχρεωτικόΠότε συνέβη η αλλαγή (UTC).
org_idintegerυποχρεωτικόapi_versionstringυποχρεωτικόΈκδοση συμβολαίου του σχήματος
data.sequenceintegerΑύξων αριθμός της παράδοσης στο πλαίσιο του webhook (λείπει για δοκιμαστικό συμβάν).
payloadstringυποχρεωτικόΤο
thinσημαίνει χωρίςdata: διαβάστε το αντικείμενο μέσω του API.Επιτρεπόμενες τιμές:
fullthindataobjectΠεδία
actor_idinteger | nullυποχρεωτικόΟ χρήστης που εκτέλεσε την ενέργεια·
nullγια ένα κλειδί API του οργανισμού ή για την ίδια την πλατφόρμα.reasonstringυποχρεωτικόΟυδέτερος κωδικός λόγου (επεκτάσιμη απαρίθμηση: θεωρήστε έναν άγνωστο κωδικό γενική αποτυχία). Τιμές:
requested,new_verifier.notestring
testbooleanυποχρεωτικόΈνα δοκιμαστικό συμβάν που στάλθηκε με
POST /v1/webhooks/{webhook_id}/test.
Παράδειγμα παράδοσης
{
"id": "evt_0123456789abcdef0123456789abcdef",
"type": "verification.requested",
"created_at": "2026-10-24T10:00:03Z",
"org_id": 1,
"api_version": "1.62.0",
"sequence": 1042,
"object": {
"type": "card",
"id": "c_9f2e41"
},
"payload": "full",
"data": {
"card": {
"id": "c_9f2e41",
"title": "Refund policy",
"collection": "support",
"collection_id": 3,
"version": 4,
"kind": "text",
"status": "ready",
"verification_state": "needs_verification",
"owner_id": 7,
"tags": [
"billing"
],
"external_id": null,
"metadata": {}
},
"actor_id": 11,
"reason": "requested",
"note": "Prices changed in October"
},
"test": false
}Λήψη συμβάντων
Κάθε παράδοση είναι ένα αίτημα POST με αυτό το σώμα JSON προς τη διεύθυνση παραλήπτη σας. Επαληθεύστε την κεφαλίδα webhook-signature (Standard Webhooks) πριν εμπιστευτείτε το σώμα, επιστρέψτε κατάσταση 2xx μέσα σε λίγα δευτερόλεπτα και κάντε την επεξεργασία μετά. Οι παραδόσεις προς ένα webhook διατηρούν τη σειρά των συμβάντων· μια αποτυχημένη παράδοση επαναλαμβάνεται με αυξανόμενες παύσεις.
Νέοι τύποι συμβάντων και νέα πεδία μπορεί να εμφανιστούν ανά πάσα στιγμή: παραλείψτε τους τύπους και τα πεδία που δεν γνωρίζετε.
Τα ίδια συμβάντα βρίσκονται στην τροφοδοσία συμβάντων για 30 ημέρες →