Skip to main content
GET
https://api.swiftpay.cx
/
api
/
webhooks
curl https://api.swiftpay.cx/api/webhooks \
  -H "Authorization: Bearer mp_live_your_api_key"

{
  "success": true,
  "data": [
    {
      "id": "wh_abc123",
      "url": "https://yoursite.com/webhooks/swiftpay",
      "events": [
        "checkout.completed",
        "checkout.failed",
        "refund.completed"
      ],
      "isActive": true,
      "description": "Production webhook handler",
      "createdAt": "2024-01-15T10:30:00Z"
    },
    {
      "id": "wh_def456",
      "url": "https://staging.yoursite.com/webhooks",
      "events": ["*"],
      "isActive": false,
      "description": "Staging environment",
      "createdAt": "2024-01-10T08:00:00Z"
    }
  ]
}

​
List Webhook Endpoints

Returns a list of all webhook endpoints configured for your business.

​
Request

​
Authorization
string
required
Bearer token with your API key

​
Response

​
success
boolean
Whether the request was successful
​
data
array
Array of webhook endpoint objects
curl https://api.swiftpay.cx/api/webhooks \
  -H "Authorization: Bearer mp_live_your_api_key"

{
  "success": true,
  "data": [
    {
      "id": "wh_abc123",
      "url": "https://yoursite.com/webhooks/swiftpay",
      "events": [
        "checkout.completed",
        "checkout.failed",
        "refund.completed"
      ],
      "isActive": true,
      "description": "Production webhook handler",
      "createdAt": "2024-01-15T10:30:00Z"
    },
    {
      "id": "wh_def456",
      "url": "https://staging.yoursite.com/webhooks",
      "events": ["*"],
      "isActive": false,
      "description": "Staging environment",
      "createdAt": "2024-01-10T08:00:00Z"
    }
  ]
}
The webhook signing secret is never returned in list responses. If you’ve lost your secret, create a new endpoint.