Overview

Swft Partner API 2026-06-01

The Swft Partner API lets SaaS platforms (agencies) onboard their own customers as Swft merchants, drive checkout sessions on their behalf, and receive lifecycle webhooks.

Authentication: opaque bearer tokens prefixed swft_ak_live_* or swft_ak_test_*. Operations that target a single merchant require the X-Swft-Merchant header.

All mutating endpoints accept an Idempotency-Key header. The wire format is pinned per request via Swft-Version (date-based, Stripe-style). New keys default to the latest version.

Information

• OpenAPI version: 3.1.0

Operations

GET

/agencies/me

POST

/agencies/{workspaceId}/merchants

PUT

/agencies/{workspaceId}/merchants/{merchantId}/pre-confirmation

POST

/agencies/{workspaceId}/merchants/{merchantId}/custom-domain

GET

/webhooks/deliveries

GET

/webhooks/deliveries/{id}

POST

/webhooks/deliveries/{id}/replay

GET

/workspaces/{workspaceId}/partner-keys

POST

/workspaces/{workspaceId}/partner-keys

DELETE

/workspaces/{workspaceId}/partner-keys/{keyId}

GET

/logs/requests

GET

/logs/requests/{request_id}

Authentication

PartnerApiKey

Partner API key. Format: swft_ak_live_* (production) or swft_ak_test_* (sandbox).

Security scheme type: http

Bearer format: opaque

MerchantApiKey

Legacy merchant API key. Used by v1 routes only.

Security scheme type: apiKey

Header parameter name: x-swft-api-key