Add 1,625 doc-sourced sample payloads across 102 providers

README.md

@@ -89,6 +89,42 @@ Each provider has a directory for each version, and each version has a file for
 
 You can manually enter the data if you'd instead not use the request receiver.
 
+### Doc-sourced samples
+
+Some providers have no captured traffic to draw on. Those carry the vendor's
+**published documentation example** instead, marked with a `source` key that a
+captured sample never has:
+
+```json
+{
+  "headers": { "content-type": "application/json" },
+  "body": { "...": "the vendor's documented example" },
+  "topic": "payment.succeeded",
+  "source": {
+    "type": "vendor-documentation",
+    "url": "https://vendor.example/docs/webhooks",
+    "retrieved": "2026-07-29"
+  }
+}
+```
+
+A provider whose samples are *all* doc-sourced also carries `doc_sourced: true`
+in its `index.json`.
+
+Two things follow from the marking:
+
+- **A capture always beats a doc example.** These are a fallback. When a real
+  request for the same provider and topic is captured, it replaces the
+  doc-sourced file — the `source` key is what makes that check possible, and its
+  absence is what identifies an observed sample.
+- **The headers are synthesized.** Vendor docs publish bodies, not deliveries, so
+  a doc-sourced file carries `content-type` plus the topic header where the
+  provider puts the event type in one. Signature headers are absent, and mock
+  sends can't produce valid signatures anyway.
+
+They come from [hookdeck/webhook-registry](https://github.com/hookdeck/webhook-registry)
+(`samples-doc/`), which records where each example was read and when.
+
 ## Using the data
 
 The data is packaged into JSON files that are distributed over http. The files can be found on https://samples.hookdeck.com

providers/adyen/1/AUTORESCUE.json

@@ -0,0 +1,37 @@
+{
+  "headers": {
+    "content-type": "application/json"
+  },
+  "body": {
+    "live": "false",
+    "notificationItems": [
+      {
+        "NotificationRequestItem": {
+          "additionalData": {
+            "retry.rescueReference": "8826173525728789",
+            "merchantOrderReference": "8826173525728789",
+            "hmacSignature": "b0ea55c2fe60d4d1d605e9c385e0e7..."
+          },
+          "amount": {
+            "currency": "EUR",
+            "value": 1000
+          },
+          "eventCode": "AUTORESCUE",
+          "eventDate": "2021-01-01T01:00:00+01:00",
+          "merchantAccountCode": "YOUR_MERCHANT_ACCOUNT",
+          "merchantReference": "YOUR_MERCHANT_REFERENCE",
+          "originalReference": "9913140798220028",
+          "pspReference": "QFQTPCQ8HXSKGK82",
+          "reason": "",
+          "success": "true"
+        }
+      }
+    ]
+  },
+  "topic": "AUTORESCUE",
+  "source": {
+    "type": "vendor-documentation",
+    "url": "https://github.com/Adyen/adyen-openapi",
+    "retrieved": "2026-07-29"
+  }
+}

providers/adyen/1/CAPTURE_FAILED.json

@@ -0,0 +1,38 @@
+{
+  "headers": {
+    "content-type": "application/json"
+  },
+  "body": {
+    "live": "false",
+    "notificationItems": [
+      {
+        "NotificationRequestItem": {
+          "additionalData": {
+            "paymentMethodVariant": "facilypay_3x",
+            "hmacSignature": "b0ea55c2fe60d4d1d605e9c385e0e7...",
+            "shopperCountry": "NL"
+          },
+          "amount": {
+            "currency": "EUR",
+            "value": 1000
+          },
+          "eventCode": "CAPTURE_FAILED",
+          "eventDate": "2021-01-01T01:00:00+01:00",
+          "merchantAccountCode": "YOUR_MERCHANT_ACCOUNT",
+          "merchantReference": "YOUR_MERCHANT_REFERENCE",
+          "originalReference": "9913140798220028",
+          "paymentMethod": "facilypay_3x",
+          "pspReference": "QFQTPCQ8HXSKGK82",
+          "reason": "Capture Failed",
+          "success": "true"
+        }
+      }
+    ]
+  },
+  "topic": "CAPTURE_FAILED",
+  "source": {
+    "type": "vendor-documentation",
+    "url": "https://github.com/Adyen/adyen-openapi",
+    "retrieved": "2026-07-29"
+  }
+}

providers/adyen/1/CHARGEBACK.json

@@ -0,0 +1,48 @@
+{
+  "headers": {
+    "content-type": "application/json"
+  },
+  "body": {
+    "live": "false",
+    "notificationItems": [
+      {
+        "NotificationRequestItem": {
+          "additionalData": {
+            "captureMerchantReference": "shopperReferenceTest",
+            "chargebackReasonCode": " 4853",
+            "InvoiceCreditorAccount": "Creditor.AdyenInvoiceService",
+            "grossCurrency": "EUR",
+            "hmacSignature": "b0ea55c2fe60d4d1d605e9c385e0e7...",
+            "defensePeriodEndsAt": "2021-07-31T03:03:07+02:00",
+            "defendable": "true",
+            "grossValue": "2000",
+            "modificationMerchantReferences": "shopperReferenceTest",
+            "chargebackSchemeCode": "mc",
+            "capturePspReference": "8636172945333378",
+            "paymentMethodVariant": "mc",
+            "shopperReference": "YOUR_SHOPPER_REFERENCE"
+          },
+          "amount": {
+            "currency": "EUR",
+            "value": 1000
+          },
+          "eventCode": "CHARGEBACK",
+          "eventDate": "2021-01-01T01:00:00+01:00",
+          "merchantAccountCode": "YOUR_MERCHANT_ACCOUNT",
+          "merchantReference": "YOUR_MERCHANT_REFERENCE",
+          "originalReference": "9913140798220028",
+          "paymentMethod": "mc",
+          "pspReference": "QFQTPCQ8HXSKGK82",
+          "reason": "Payment.TxId=300000000524534724 dispute",
+          "success": "true"
+        }
+      }
+    ]
+  },
+  "topic": "CHARGEBACK",
+  "source": {
+    "type": "vendor-documentation",
+    "url": "https://github.com/Adyen/adyen-openapi",
+    "retrieved": "2026-07-29"
+  }
+}

providers/adyen/1/CHARGEBACK_REVERSED.json

@@ -0,0 +1,35 @@
+{
+  "headers": {
+    "content-type": "application/json"
+  },
+  "body": {
+    "live": "false",
+    "notificationItems": [
+      {
+        "NotificationRequestItem": {
+          "additionalData": {
+            "hmacSignature": "b0ea55c2fe60d4d1d605e9c385e0e7..."
+          },
+          "amount": {
+            "currency": "EUR",
+            "value": 1000
+          },
+          "eventCode": "CHARGEBACK_REVERSED",
+          "eventDate": "2021-01-01T01:00:00+01:00",
+          "merchantAccountCode": "YOUR_MERCHANT_ACCOUNT",
+          "merchantReference": "YOUR_MERCHANT_REFERENCE",
+          "paymentMethod": "mc",
+          "pspReference": "QFQTPCQ8HXSKGK82",
+          "reason": "Fraudulent Processing of Transactions",
+          "success": "true"
+        }
+      }
+    ]
+  },
+  "topic": "CHARGEBACK_REVERSED",
+  "source": {
+    "type": "vendor-documentation",
+    "url": "https://github.com/Adyen/adyen-openapi",
+    "retrieved": "2026-07-29"
+  }
+}

providers/adyen/1/DISPUTE_DEFENSE_PERIOD_ENDED.json

@@ -0,0 +1,39 @@
+{
+  "headers": {
+    "content-type": "application/json"
+  },
+  "body": {
+    "live": "true",
+    "notificationItems": [
+      {
+        "NotificationRequestItem": {
+          "additionalData": {
+            "chargebackReasonCode": "10.4",
+            "modificationMerchantReferences": "",
+            "chargebackSchemeCode": "visa",
+            "disputeStatus": "Lost"
+          },
+          "amount": {
+            "currency": "EUR",
+            "value": 1000
+          },
+          "eventCode": "DISPUTE_DEFENSE_PERIOD_ENDED",
+          "eventDate": "2024-11-11T01:30:57+01:00",
+          "merchantAccountCode": "YOUR_MERCHANT_ACCOUNT",
+          "merchantReference": "YOUR_REFERENCE",
+          "originalReference": "9914444444444444",
+          "paymentMethod": "visa",
+          "pspReference": "9915555555555555",
+          "reason": "Other Fraud-Card Absent Environment",
+          "success": "true"
+        }
+      }
+    ]
+  },
+  "topic": "DISPUTE_DEFENSE_PERIOD_ENDED",
+  "source": {
+    "type": "vendor-documentation",
+    "url": "https://github.com/Adyen/adyen-openapi",
+    "retrieved": "2026-07-29"
+  }
+}

providers/adyen/1/EXPIRE.json

@@ -0,0 +1,31 @@
+{
+  "headers": {
+    "content-type": "application/json"
+  },
+  "body": {
+    "live": "false",
+    "notificationItems": [
+      {
+        "NotificationRequestItem": {
+          "amount": {
+            "currency": "EUR",
+            "value": 1000
+          },
+          "eventCode": "EXPIRE",
+          "eventDate": "2024-02-09T11:19:48+01:00",
+          "merchantAccountCode": "YOUR_MERCHANT_ACCOUNT",
+          "merchantReference": "YOUR_MERCHANT_REFERENCE",
+          "pspReference": "QFQTPCQ8HXSKGK82",
+          "reason": "",
+          "success": "true"
+        }
+      }
+    ]
+  },
+  "topic": "EXPIRE",
+  "source": {
+    "type": "vendor-documentation",
+    "url": "https://github.com/Adyen/adyen-openapi",
+    "retrieved": "2026-07-29"
+  }
+}

providers/adyen/1/INFORMATION_SUPPLIED.json

@@ -0,0 +1,38 @@
+{
+  "headers": {
+    "content-type": "application/json"
+  },
+  "body": {
+    "live": "true",
+    "notificationItems": [
+      {
+        "NotificationRequestItem": {
+          "additionalData": {
+            "chargebackReasonCode": "13.3",
+            "chargebackSchemeCode": "visa",
+            "disputeStatus": "Pending"
+          },
+          "amount": {
+            "currency": "USD",
+            "value": 10000
+          },
+          "eventCode": "INFORMATION_SUPPLIED",
+          "eventDate": "2025-05-17T09:35:14+02:00",
+          "merchantAccountCode": "YOUR_MERCHANT_ACCOUNT",
+          "originalReference": "9914444444444444",
+          "merchantReference": "YOUR_REFERENCE",
+          "paymentMethod": "visa",
+          "pspReference": "9915555555555555",
+          "reason": "Not as Described or Defective Merchandise/Services",
+          "success": "true"
+        }
+      }
+    ]
+  },
+  "topic": "INFORMATION_SUPPLIED",
+  "source": {
+    "type": "vendor-documentation",
+    "url": "https://github.com/Adyen/adyen-openapi",
+    "retrieved": "2026-07-29"
+  }
+}

providers/adyen/1/ISSUER_COMMENTS.json

@@ -0,0 +1,46 @@
+{
+  "headers": {
+    "content-type": "application/json"
+  },
+  "body": {
+    "live": "false",
+    "notificationItems": [
+      {
+        "NotificationRequestItem": {
+          "additionalData": {
+            "chargebackReasonCode": "13.3",
+            "chargebackSchemeCode": "visa",
+            "issuerComments.type": "chargeback",
+            "issuerComments.disputeAmountChangeReason": "some_text",
+            "issuerComments.cancellationMethod": "some_text",
+            "issuerComments.orderDetailsNotAsDescribed": "some_text",
+            "issuerComments.explanation": "some_text",
+            "issuerComments.damagedOrDefectiveOrderInfo": "some_text",
+            "issuerComments.howChAttemptReturnAndDispOfMerchandise": "some_text",
+            "issuerComments.whatWasNotReceived": "some_text",
+            "issuerComments.cancellationDate": "date_of_cancellation"
+          },
+          "amount": {
+            "currency": "EUR",
+            "value": 1000
+          },
+          "eventCode": "ISSUER_COMMENTS",
+          "eventDate": "2025-05-17T09:35:14+02:00",
+          "merchantAccountCode": "YOUR_MERCHANT_ACCOUNT",
+          "originalReference": "9914444444444444",
+          "merchantReference": "YOUR_REFERENCE",
+          "paymentMethod": "visa",
+          "pspReference": "9915555555555555",
+          "reason": "Not as Described or Defective Merchandise/Services",
+          "success": "true"
+        }
+      }
+    ]
+  },
+  "topic": "ISSUER_COMMENTS",
+  "source": {
+    "type": "vendor-documentation",
+    "url": "https://github.com/Adyen/adyen-openapi",
+    "retrieved": "2026-07-29"
+  }
+}