Boek een demo
Menu

Developers

Integreer QR Wallet via de v2-API

De v2-API werkt over gewone REST-calls in JSON. Token-scopes bepalen wat een integratie mag, een Idempotency-Key voorkomt dubbele verwerkingen bij een retry, en fouten komen terug volgens de RFC 7807-standaard.

Vraag toegang tot de API aanBoek een demo
POST/v2/top-upswallet_ops
curl -X POST https://api.qr-wallet.app/v2/top-ups \
  -H "Authorization: Bearer live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Idempotency-Key: 3f1c9a02-6b7d-4e21-9c3a-1d8f7b2e5a90" \
  -H "Content-Type: application/json" \
  -d '{
    "walletId": "wal_9f3kD8mQ2xLpZ7Rt",
    "amount": { "currency": "EUR", "value": "25.00" },
    "description": "Top-up at the bar",
    "redirectUrl": "https://example.com/return"
  }'
{
  "resource": "top-up",
  "id": "tup_2mQpL9RxZa8Wc3Vt",
  "livemode": true,
  "amount": { "currency": "EUR", "value": "25.00" },
  "method": "mollie",
  "status": "open",
  "walletId": "wal_9f3kD8mQ2xLpZ7Rt",
  "description": "Top-up at the bar",
  "createdAt": "2026-09-02T10:15:00.000Z",
  "paidAt": null,
  "reversedCents": 0,
  "syncBlockedReason": null,
  "_links": {
    "self": { "href": "https://api.qr-wallet.app/v2/top-ups/tup_2mQpL9RxZa8Wc3Vt" },
    "checkout": { "href": "https://www.mollie.com/checkout/select-method/7UhSN1zuXS" }
  }
}

Wat je moet weten voor je bouwt

  • Scopes

    Een key draagt de scopes die je kiest: wallet_ops voor wallets, top-ups en betalingen, webhooks voor je endpoints, admin voor je PSP- en facturatie-instellingen.

  • Idempotency

    Herhaal je een aanvraag met dezelfde Idempotency-Key, bijvoorbeeld na een mislukte verbinding, dan verwerken we ze niet opnieuw: je krijgt het antwoord van de eerste keer terug.

  • Foutmeldingen (RFC 7807)

    Fouten komen terug als application/problem+json, met de HTTP-status, een titel en meestal een detail dat zegt wat er mis was. Waar je erop moet kunnen programmeren staat er een vaste code bij, zoals insufficient_scope of subscription_lapsed.

Zo integreer je

  • Vraag toegang aan

    Vertel wat je wil bouwen. Je krijgt test-keys en de API-documentatie terug.

  • Test in testmodus

    Bouw tegen een testwallet. Top-ups lopen via een mock-provider die je zelf laat slagen, zonder echte betalingen.

  • Ga live

    Wissel naar live keys zodra je klaar bent. Dezelfde endpoints, nu met echte data.

Wil je toegang tot de API?

We reageren zelf, meestal binnen één werkdag.

Vraag toegang tot de API aan
Boek een demo