Webhooks

Nexa's receiver for Tesser's outbound webhooks.

Receive Tesser webhook (Nexa implements this)

POST

https://nexa-poc-main-c82e5ac.zuplo.app

/v1/webhooks/tesser

Nexa-hosted receiver for Tesser's standard outbound webhooks (§6.7). The subscription Nexa needs is the withdrawal events behind the treasury withdrawals of §9.2. Envelope and event types are Tesser's existing ones; https://docs.tesser.xyz is the normative definition and this document does not re-specify them; the schema below is orientation only. Delivery auth: see the Authentication & environments page (mTLS, plus Tesser's Ed25519 X-Tesser-Signature header).

Receive Tesser webhook (Nexa implements this) › Request Body

Tesser's standard outbound webhook envelope, reproduced here for orientation only. https://docs.tesser.xyz is the normative definition (spec §6.7 documents the subscription Nexa needs rather than re-specifying Tesser's existing envelope). Note this is NOT the Nexa-to-Tesser WebhookEnvelope of §7; the two directions use each sender's own existing format.

TesserWebhookEnvelope

id

string · required

Event identifier (UUID), the dedupe key.

type

string · required

Event type in scope.action form. The subscription Nexa needs is the withdrawal events behind §9.2: withdrawal.quote_created, withdrawal.steps_created, withdrawal.balance_updated, withdrawal.updated.

created_at

string · date-time · required

object · required

Event payload wrapper.

Receive Tesser webhook (Nexa implements this) › Responses

Delivery accepted. Tesser treats any 2xx as success; a production receiver may return a truly empty body, and the empty object below is the explicit contract this document specifies so every operation has a schema and an example.

POST/v1/webhooks/tesser

curl https://nexa-poc-main-c82e5ac.zuplo.app/v1/webhooks/tesser \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "id": "a7d2e5b1-0000-4000-8000-000000000001",
  "type": "withdrawal.updated",
  "created_at": "2026-10-14T17:45:09.045Z",
  "data": {
    "object": {
      "id": "7c1d0b44-0000-4000-8000-000000000001",
      "organization_reference_id": "nexa-withdrawal-0001"
    }
  }
}'

Example Request Body

{
  "id": "a7d2e5b1-0000-4000-8000-000000000001",
  "type": "withdrawal.updated",
  "created_at": "2026-10-14T17:45:09.045Z",
  "data": {
    "object": {
      "id": "7c1d0b44-0000-4000-8000-000000000001",
      "organization_reference_id": "nexa-withdrawal-0001"
    }
  }
}

json

application/json

Example Responses

{}

json

application/json

Payments

Receive Tesser webhook (Nexa implements this)

POST

https://nexa-poc-main-c82e5ac.zuplo.app

/v1/webhooks/tesser

Receive Tesser webhook (Nexa implements this) › Request Body

TesserWebhookEnvelope

id

string · required

Event identifier (UUID), the dedupe key.

type

string · required

Event type in scope.action form. The subscription Nexa needs is the withdrawal events behind §9.2: withdrawal.quote_created, withdrawal.steps_created, withdrawal.balance_updated, withdrawal.updated.

created_at

string · date-time · required

object · required

Event payload wrapper.