Adyen

Overview

The Adyen connector receives standard webhooks from your merchant accounts and turns each notification item into a typed event. Tessel checks the HMAC signature on every item, acknowledges with [accepted] and keeps the raw payload in the trace.

Payments teams use it to capture orders once a warehouse confirms shipment, to open a Zendesk ticket with defense documents when a chargeback lands and to load settlement reports into Snowflake.

Event coverage

• AUTHORISATION, CAPTURE, CANCELLATION and REFUND

• CHARGEBACK, NOTIFICATION_OF_CHARGEBACK and SECOND_CHARGEBACK

• REPORT_AVAILABLE for settlement and payment accounting reports

How webhooks work

Adyen posts notification items to a Tessel URL in your workspace region. Tessel validates the signature with your HMAC key, checks the item against the schema and starts the matching workflow. Captures and refunds are asynchronous, so Tessel waits for the confirming webhook before marking a step done.

{
  "eventCode": "AUTHORISATION",
  "success": "true",
  "pspReference": "QFQTPCQ8HXSKGK82",
  "merchantReference": "order-48213",
  "amount": { "currency": "EUR", "value": 12900 },
  "additionalData": { "hmacSignature": "..." }
}

{
  "eventCode": "AUTHORISATION",
  "success": "true",
  "pspReference": "QFQTPCQ8HXSKGK82",
  "merchantReference": "order-48213",
  "amount": { "currency": "EUR", "value": 12900 },
  "additionalData": { "hmacSignature": "..." }
}

{
  "eventCode": "AUTHORISATION",
  "success": "true",
  "pspReference": "QFQTPCQ8HXSKGK82",
  "merchantReference": "order-48213",
  "amount": { "currency": "EUR", "value": 12900 },
  "additionalData": { "hmacSignature": "..." }
}

Retries

If Tessel is unreachable, Adyen retries with backoff and queues later items. Tessel deduplicates by pspReference and event code, so a retried notification never starts a second run.

Permissions needed

Create a separate API credential for Tessel. It needs webservice roles for the actions you use. Report access is only required for the report trigger.

• Checkout webservice role for captures, cancels and refunds

• Merchant PAL Webservice role for modifications on older integrations

• Merchant Report Download role only if you download reports