SwissPay Developer Docs

Welcome. This is the reference for the SwissPay API — the public endpoints you can call today to create payments and manage customers.

ℹ️ Note

The SwissPay API is live at https://app.swisspay.ai. Use a test key (sk_test_…) for development and a live key (sk_live_…) to move real money — the same base URL serves both, and the key you send decides the mode. Questions? Write to support@swisspay.ai.

I want to…

• Make my first API call → Quickstart
• Get an API key → Authentication
• Understand idempotent retries → Idempotency
• Handle declines and errors correctly → Errors
• Use test cards in test mode → Test cards
• Create a payment → Payments
• Create a customer → Customers
• Let an AI agent call the API → Using the API with AI agents (MCP)
• Get the OpenAPI spec → OpenAPI specification

Need help?

• Look something up in the glossary.
• Email support@swisspay.ai — we usually respond within one business day.
• Report a security issue: see Responsible disclosure.