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
    (append manualamount).
CountryagainstDynamic destinationStatic (manual amount)
ArgentinaARSqr3qr3manualamount
BrazilBRLpixpixmanualamount
ColombiaCOPmanteca-breb-qamanteca-breb-qa-manual-amount
ParaguayPYGparaguayparaguaymanualamount
PeruPEN0002015802PE0102115204482953036045912P2P Transfer26560116Plin Network P2P00327b4494a37257495b951858f7718f24606004Lima6304D922append manualamount to the end
BoliviaBOBoqIAHpbaIOj4947ECRwTSMZdmJ6hAptkrwBMTQ8bMvOX/JIszXkVpR4JMih9wWS9093zC9qt/c7SRlDY4iYK9zu9DpFdOTTFOEA+rPtaaOqM/eJZFnrgHpotIWbFsv+1kXiLmLli4P/QGr8GuuQ5QBH2mulShUNkljHSTc0tugUwQtJaHW5ZDmhEvU5lVWZkscu6YS72keEpJhYNfJ2KQ1lzdhKElTj+Fg1MyIQFF/kOq4ejjAgDXCnQEPBqog04M4SVqNiKQbOg2sD2VhMGsHolfPr5AST/Rk2rAdQ8y2D3YuflWmU6X8sP9gKNBasev0gKupluXqVQuMozTdgADQ==|6497E3319343ED0DA8514FFEappend manualamount to the end
VenezuelaUSDT, USDCCLvenezuelavenezuelamanualamount

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.


Did this page help you?