🔑API Key

Learn how to access your Swapped Commerce API Key, which is required when creating payments and interacting with the Swapped Commerce API.

Get your API Key

To retrieve your API Key, visit the Developers section of the Swapped Commerce dashboard. There, you can generate and view your API Key, which is required for specific Swapped Commerce endpoints.

If you lose your API Key or believe it has been compromised, you should delete the API credentials and request a new one immediately.

If you believe your merchant account has been compromised, please contact us immediately.

API Key Types

Swapped Commerce supports two types of API Keys, each designed for a different use-case and secured using the cryptographic method most appropriate for that workflow:

Key Type	Purpose	Cryptography	Use Case
Webhook	Verifying the authenticity of webhook events sent from Swapped to you.	HMAC (symmetric)	Ensures events you receive truly originated from Swapped.
API Client	Signing requests you send to the Swapped Commerce Balance, KYC, and Payout APIs.	Ed25519 (asymmetric)	Strong, tamper-proof request signing without mutual storage private secrets (you store, we forget).

Which Keys Do You Need?

Key Usage Type	Products
Webhook Signature	Webhooks
Public API Access	Orders, Payment Routes, Quotes, Blockchains, Currencies
Private API Access	KYC, Balance Checks, Payouts