# Veracity Pay

> A test payment service provider built for AI-driven development. It emulates Stripe, Nets Easy, Adyen and Kustom (formerly Klarna Checkout): 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.

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.

## 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.
- 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.