Sandbox
Neither host serves traffic yet. Until then, build against a mock generated from the OpenAPI document; the values below are the contract the sandbox will follow.
| Environment | Host | Keys |
|---|---|---|
| Sandbox | https://payments-api.mrcr.io |
psbox_… |
| Production | https://payments-api.mercuryo.io |
plive_… |
A key works only on its own host. No money moves in the sandbox; webhooks are sent and signed as in production.
Force an outcome with the amount
The cents of amount.value select the outcome. Each method page lists the cents it takes; other
cents give the success path of the method. Machine-readable: x-test-amounts in the OpenAPI document.
| Cents | Example | Outcome | Methods |
|---|---|---|---|
| any other | 10.00 |
Success path: completed (card with a hold: authorized) |
all |
.51 |
10.51 |
failed — provider_declined |
all |
.52 |
10.52 |
failed — risk_rejected |
all |
.53 |
10.53 |
failed — limit_exceeded |
card payout |
.54 |
10.54 |
failed — card_not_supported |
card, Apple Pay, Google Pay, card payout |
.55 |
10.55 |
failed — method_unavailable |
all |
.56 |
10.56 |
failed — internal_error |
all |
.57 |
10.57 |
requires_action, then completed after the payer step |
Google Pay |
.58 |
10.58 |
requires_action, then failed — provider_declined; BLIK: canceled_by_payer |
Google Pay, BLIK |
.60 |
10.60 |
failed — invalid_recipient_details |
card payout |
.61 |
10.61 |
processing for 60 seconds, then completed |
card, Apple Pay, Google Pay, card payout |
A card payin always starts at the payment page: in the sandbox it shows Pass and Fail buttons.
In the sandbox the requires_action redirect opens a Mercuryo test page with Pass and Fail
buttons; for BLIK await_confirmation the step completes by itself after 5 seconds. Test data — also x-test-fixtures in the OpenAPI document:
| Method | Test data |
|---|---|
| Card | Any Luhn-valid number, any future expiry, any CVC |
| BLIK | Any six digits |
| Apple Pay | apple_pay.payment_token: test_apple_pay_token_visa, or a real token from Apple Pay in its sandbox environment. createApplePaySession returns a stub session for apple-pay-gateway-cert.apple.com |
| Google Pay | google_pay.payment_token: test_google_pay_token_visa, or a real token from Google Pay in its TEST environment |
Test endpoints
Sandbox keys only. Not supported yet.
| Endpoint | What it does |
|---|---|
POST /v2/test/transactions/{transaction_id}/advance |
Moves a test transaction one step along x-status-transitions and sends the webhooks |
POST /v2/test/webhooks |
Sends a signed sample event of the given type to the shop webhook URL |
Next: Glossary
