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-upstop_ups:write
curl -X POST https://api.qr-wallet.app/v2/top-ups \
  -H "Authorization: Bearer live_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Idempotency-Key: 3f1c9a02-6b7d-4e21-9c3a-1d8f7b2e5a90" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_id": "wal_9Hk3RpXn2",
    "amount": { "currency": "EUR", "value": "25.00" },
    "method": "bancontact"
  }'
{
  "id": "top_5Qm1Tv8Ln",
  "wallet_id": "wal_9Hk3RpXn2",
  "status": "pending",
  "amount": { "currency": "EUR", "value": "25.00" },
  "checkout_url": "https://pay.qr-wallet.app/t/5Qm1Tv8Ln"
}

Wat je moet weten voor je bouwt

  • Scopes

    Elk token krijgt exact de rechten die het nodig heeft. Een token voor je kassascherm kan dus niet uitbetalen.

  • 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 een type, een titel, en een aanwijzing naar waar het precies misging in je aanvraag.

Zo integreer je

  • Vraag toegang aan

    Vertel wat je wil bouwen. Je krijgt sandbox-keys en documentatie terug.

  • Test in de sandbox

    Bouw en test tegen een sandbox-wallet met saldo, zonder echte betalingen.

  • Ga live

    Wissel naar production 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