Testing QR payments
Testing QR payments
Every QR payment flow can be tested end-to-end in the sandbox
(https://sandbox.manteca.dev) with no real funds. Use one of the test
destinations below as paymentDestination when previewing a payment, then
confirm and track it as usual.
Each test destination is detected as its country, routed to a mock provider, and
auto-completed — so you can validate your full integration (preview → execute →
webhooks) without scanning a real QR.
Test destinations by country
Each country has two variants:
- Dynamic — the QR carries the amount (the mock returns one for you).
- Static — the QR has no amount and the payer enters it manually
(appendmanualamount).
| Country | against | Dynamic destination | Static (manual amount) |
|---|---|---|---|
| Argentina | ARS | qr3 | qr3manualamount |
| Brazil | BRL | pix | pixmanualamount |
| Colombia | COP | manteca-breb-qa | manteca-breb-qa-manual-amount |
| Paraguay | PYG | paraguay | paraguaymanualamount |
| Peru | PEN | 0002015802PE0102115204482953036045912P2P Transfer26560116Plin Network P2P00327b4494a37257495b951858f7718f24606004Lima6304D922 | append manualamount to the end |
| Bolivia | BOB | oqIAHpbaIOj4947ECRwTSMZdmJ6hAptkrwBMTQ8bMvOX/JIszXkVpR4JMih9wWS9093zC9qt/c7SRlDY4iYK9zu9DpFdOTTFOEA+rPtaaOqM/eJZFnrgHpotIWbFsv+1kXiLmLli4P/QGr8GuuQ5QBH2mulShUNkljHSTc0tugUwQtJaHW5ZDmhEvU5lVWZkscu6YS72keEpJhYNfJ2KQ1lzdhKElTj+Fg1MyIQFF/kOq4ejjAgDXCnQEPBqog04M4SVqNiKQbOg2sD2VhMGsHolfPr5AST/Rk2rAdQ8y2D3YuflWmU6X8sP9gKNBasev0gKupluXqVQuMozTdgADQ==|6497E3319343ED0DA8514FFE | append manualamount to the end |
| Venezuela | USDT, USDCCL | venezuela | venezuelamanualamount |
Forcing a failure or a refund
Append failure to any destination above to make the payment fail — the
synthetic moves to CANCELLED. For example: qr3failure.
Refunds can be tested with Argentina and Brazil: append refund to a qr3 or
pix destination (e.g. pixrefund). The payment completes, then a refund is
issued ~30s later, emitting a PAYMENT_REFUND webhook.
To test an expired or inactive QR in Peru, Colombia or Venezuela, include inactive in the destination (for example venezuelainactive). The lock fails with PAYMENT_DESTINATION_EXPIRED (409).
See Preview a payment and Make a payment for
the full flow and the per-country sender fields.
Updated 27 days ago