# Veracity Pay

> A test payment service provider built for AI-driven development. It emulates Stripe, Nets Easy, Adyen, Kustom, Swish Handel, Svea Checkout, Walley Checkout, Qliro One: hosted checkout, cards, Swish, invoice and instalments, subscriptions with renewals, refunds and signed webhooks. No money moves; a payment is approved with a six-digit code sent to the payer's e-mail. Free to use for now. A live demo shop that runs every emulated partner is at https://pay.veracity.se/demo.

Each flavour mirrors the original provider's paths, fields, auth and callbacks, so going live means changing only the keys and the host. Every guide links the original documentation and lists the deviations.

The fastest path for a coding agent is the MCP server: `claude mcp add --transport http veracity-pay https://pay.veracity.se/mcp`. Then tell the agent: "I want us to use Veracity Pay to emulate payments in this project." It asks which payment partners to emulate and which e-mail to use, registers an account and the developer receives the keys and commands by e-mail. The agent never sees a secret.

## Docs
- [Full reference for agents](https://pay.veracity.se/llms-full.txt): every endpoint, webhook, test outcome and magic value.
- [Human docs](https://pay.veracity.se/docs) (Swedish and English).
- [TypeScript client](https://pay.veracity.se/sdk.ts): dependency-free client and webhook verification.
- [Webhook listener for localhost](https://pay.veracity.se/listen.mjs).

## Integration guides
- [Stripe](https://pay.veracity.se/guides/stripe.md): Checkout Sessions, PaymentIntents, subscriptions, refunds and webhooks (complete).
- [Nets Easy](https://pay.veracity.se/guides/nets.md): Payment API v1 with the hosted payment page, charges, refunds and webhooks.
- [Adyen](https://pay.veracity.se/guides/adyen.md): Checkout API v71: sessions (Hosted Checkout), /payments and HMAC-signed notifications.
- [Kustom](https://pay.veracity.se/guides/kustom.md): Checkout v3 (formerly Klarna Checkout) with html_snippet, push and order management.
- [Swish Handel](https://pay.veracity.se/guides/swish.md): Swish Commerce API: payment requests (e-commerce and m-commerce), refunds, callbacks and recurring payments – without certificates.
- [Svea Checkout](https://pay.veracity.se/guides/svea.md): Checkout API and Payment Admin with Svea-signed calls, push and delivery/credit.
- [Walley Checkout](https://pay.veracity.se/guides/walley.md): Checkout with OAuth2, notifications and order management (activate, refund, cancel).
- [Qliro One](https://pay.veracity.se/guides/qliro.md): Merchant API with Qliro-signed calls, status push and order management.

## MCP
- Endpoint: https://pay.veracity.se/mcp (Streamable HTTP). Tools: list_providers, register_merchant, integration_guide, key_status, extend_key, complete_checkout, set_next_charge_outcome, advance_clock, simulate_outage.
- Test helpers authenticate with the developer's secret key in an Authorization header in the MCP client config, never in the chat.

## Optional
- [Dashboard](https://pay.veracity.se/dashboard): keys (valid one month at a time, one-click extend), payments, refunds, subscriptions, webhooks.
- [My payments](https://pay.veracity.se/konto): the payer's portal across merchants.