# Veracity Pay

> A test payment service provider built for AI-driven development. It emulates Adyen, Kustom, Ledyer Checkout, Nets Easy, Qliro One, Stripe, Svea Checkout, Swedbank Pay, Swish Handel, Two, Walley 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. 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
- [Adyen](https://pay.veracity.se/guides/adyen.md): Checkout API v72 (v68–v72): sessions (Hosted Checkout), /payments, Pay by Link, stored payment methods and HMAC-signed notifications.
- [Kustom](https://pay.veracity.se/guides/kustom.md): Checkout v3 (formerly Klarna Checkout) with html_snippet, validation and shipping options at the shop, push, customer tokens and order management.
- [Ledyer Checkout](https://pay.veracity.se/guides/ledyer.md): B2B checkout for companies: OAuth2, order sessions, the embedded checkout with bootstrap.js, credit checks with Ledyer's test companies, company search, validation, notifications and order management per sub-order (capture, refund, cancel).
- [Nets Easy](https://pay.veracity.se/guides/nets.md): Payment API v1 with the hosted or embedded payment page, charges, refunds, subscriptions, saved cards for later charges (uCoF) and webhooks.
- [Qliro One](https://pay.veracity.se/guides/qliro.md): Merchant API with Qliro-signed calls, validation, company purchases, saved cards, status push and order management.
- [Stripe](https://pay.veracity.se/guides/stripe.md): Checkout Sessions, PaymentIntents, subscriptions, coupons and promotion codes, Payment Links, refunds, webhooks and an emulated Stripe.js with the Payment Element (complete).
- [Svea Checkout](https://pay.veracity.se/guides/svea.md): Checkout API and Payment Admin with Svea-signed calls, validation, company purchases, campaigns, saved cards, push and delivery/credit.
- [Swedbank Pay](https://pay.veracity.se/guides/swedbankpay.md): Checkout v3 (Payment Menu): payment orders, redirect and Seamless View, callbacks, capture, cancel, reversal, Verify, one-click and token-based recurring payments.
- [Swish Handel](https://pay.veracity.se/guides/swish.md): Swish Commerce API: payment requests (e-commerce and m-commerce), refunds, payouts, callbacks and recurring payments – without certificates.
- [Two](https://pay.veracity.se/guides/two.md): B2B invoice (buy now, pay later for companies): Company API, order intent, orders the buyer verifies, confirm, full or partial fulfilment (child orders), refunds and Svix-signed webhooks.
- [Walley Checkout](https://pay.veracity.se/guides/walley.md): Checkout with OAuth2, validation, company purchases, customer tokens for subscriptions, notifications and order management (activate, refund, cancel).
- Not listed, since Swedish merchants reach it only through partners: [Billie](https://pay.veracity.se/guides/billie.md): Billie Direct API (B2B invoice in Germany, EUR): OAuth, hosted payment page and widget with confirmation, backend orders, partial invoices, credit notes, cancellation, legal forms and webhooks with a static header.

## MCP
- Endpoint: https://pay.veracity.se/mcp (Streamable HTTP). Tools: list_providers, register_merchant, integration_guide, request_feature, key_status, extend_key, list_recent_checkouts, complete_checkout, list_webhook_endpoints, update_webhook_endpoint, list_webhook_deliveries, resend_webhook_delivery, set_next_charge_outcome, simulate_outage, 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, and members (the owner invites teammates by e-mail).
- [My payments](https://pay.veracity.se/konto): the payer's portal across merchants.
- [Online payments from scratch](https://pay.veracity.se/onlinebetalningar?lang=en): the purchase flow, reserve and capture, webhooks, refunds and recurring payments, with what each step is called at each provider.
- [Requests](https://pay.veracity.se/onskemal): ask for a missing payment method or payment partner (the MCP tool request_feature does the same).