For the complete documentation index, see llms.txt. This page is also available as Markdown.

Testing

Choose the right way to validate your integration in Sandbox.

Testing

Bead supports several ways to validate your integration in Sandbox. This section helps you choose the right test method and links to a step by step guide for each one.

Choosing a Test Method

For most integrators, Klarna is the recommended default. It exercises the full end to end payment flow, create payment, hosted checkout, completion, and webhook or status confirmation, without requiring any real assets. Klarna provides sandbox test credentials, so you can prove your integration works before touching a live wallet or crypto network.

Pick your test method based on your terminal type and what you need to prove.

Test method
Terminal type
Real assets required?
Best for

Klarna (recommended)

Virtual and physical

No. Uses Klarna sandbox test credentials

The default way to prove the full payment flow works, on either terminal type

Venmo

Virtual only

No. Sandbox does not draw from a live wallet

Validating the wallet redirect and QR flow on a virtual terminal

PayPal

Virtual only

No. Uses a sandbox PayPal test account

Validating the wallet approval flow on a virtual terminal

Crypto (USDC, BTC, Lightning)

Virtual and physical

Yes. Live blockchain networks, real assets plus network fee tokens

Only when you specifically need to validate a crypto tender

Start here

If you only need to confirm that your API keys, terminal configuration, hosted payment page, and webhooks all work together, run a Klarna test first. It is the fastest path to a completed payment and needs no funded wallet.

If you are integrating on a virtual terminal and want to validate wallet based tenders, you can also test Venmo and PayPal. Both complete in Sandbox without drawing from a live account.

Reach for crypto testing only when a crypto tender is in scope for your integration. Sandbox crypto payments run on live blockchain networks and require real assets plus a network fee token, so keep test amounts small.

Guides in this section

  • Test with Klarna (recommended) — full sandbox walkthrough for virtual and physical terminals

  • Test with Venmo — virtual terminal wallet flow

  • Test with PayPal — virtual terminal wallet flow

  • Test Crypto Payments — live network testing, wallet funding, and fee tokens

  • Run a Test Payment in the API Reference — fire a test payment from your browser

Last updated