Skip to main content
POST
/
v2
/
webhooks
Create webhooks
curl --request POST \
  --url https://sandbox.gateway.sezzle.com/v2/webhooks \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "https://example.com/webhooks",
  "events": [
    "customer.tokenized"
  ]
}
'
{
  "uuid": "747cf28a-bb5c-46a8-a288-d9b006fd6113",
  "links": [
    {
      "href": "https://sandbox.gateway.sezzle.com/v2/webhooks",
      "rel": "create",
      "method": "POST"
    },
    {
      "href": "https://sandbox.gateway.sezzle.com/v2/webhooks",
      "rel": "list",
      "method": "GET"
    },
    {
      "href": "https://sandbox.gateway.sezzle.com/v2/webhooks/747cf28a-bb5c-46a8-a288-d9b006fd6113",
      "rel": "self",
      "method": "GET"
    },
    {
      "href": "https://sandbox.gateway.sezzle.com/v2/webhooks/747cf28a-bb5c-46a8-a288-d9b006fd6113",
      "rel": "self",
      "method": "PATCH"
    },
    {
      "href": "https://sandbox.gateway.sezzle.com/v2/webhooks/747cf28a-bb5c-46a8-a288-d9b006fd6113",
      "rel": "self",
      "method": "DELETE"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.sezzle.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Valid Webhook Events

We accept the following Webhook events
EventTrigger
customer.tokenizedA customer is tokenized
order.authorizedAn order is authorized by Sezzle
order.capturedAn order is captured by Sezzle
order.refundedAn order is refunded by Sezzle
dispute.merchant_input_requestedA dispute is filed by a shopper and merchant input is required
dispute.deadline_approachingA dispute is moved to final notice by Sezzle
dispute.closed.customer_winThe shopper wins the dispute and the order is refunded
dispute.closed.merchant_winThe merchant wins the dispute and it is resolved in their favor
dispute.closed.neutralNo clear winner is determined and the dispute is resolved neutrally

Authorizations

​
Authorization
string
header
required

The authentication token generated from providing API Keys to Sezzle Gateway

Body

application/json
​
url
string
required

The URL you are using to receive webhooks

​
events
enum<string>[]
required

An array of webhook events you wish to subscribe to

Available options:
customer.tokenized,
order.authorized,
order.captured,
order.refunded,
dispute.merchant_input_requested,
dispute.deadline_approaching,
dispute.closed.customer_win,
dispute.closed.merchant_win,
dispute.closed.neutral

Response

Successful Operation

​
uuid
string

The unique identifier for this response

​
links
object[]

Available API links prefilled with UUID with accompanying method