Presto API v1 referentie

De v1-referentie van de Presto Developer API. Alle endpoints werken met een API-sleutel en vereisen een actief Presto Pro-abonnement.

Bruno-collectie

Alle requests kant-en-klaar, inclusief het sleutelbeheer (API-sleutel aanmaken, oplijsten en intrekken) en omgevingen voor test en productie. Importeer het .zip-bestand in Bruno.

Bruno-collectie downloaden (.zip)

Basis-URL

https://app.getpresto.be/api/v1

Authenticatie

Stuur je sleutel mee als bearer-token in de Authorization-header. Zet daarnaast Accept: application/json zodat je altijd JSON terugkrijgt.

Authorization: Bearer presto_JOUW_SLEUTEL
Accept: application/json

Endpoints

POST /qr-codes : een nieuwe QR-code aanmaken
GET /qr-codes : je QR-codes oplijsten
GET /qr-codes/{id} : Ã©Ã©n QR-code opvragen
GET /qr-codes/{id}/image : de QR-code als PNG-afbeelding

Een QR-code aanmaken

Verstuur een POST naar /qr-codes met de gegevens van de betaling:

curl -X POST https://app.getpresto.be/api/v1/qr-codes 
  -H "Authorization: Bearer presto_JOUW_SLEUTEL" 
  -H "Content-Type: application/json" 
  -H "Accept: application/json" 
  -d '{
    "title": "Lidgeld 2026",
    "to": "KSK Voorbeeld",
    "amount": 25.00,
    "iban": "BE68 5390 0754 7034",
    "message": "Lidgeld Jan Peeters"
  }'

Velden

title (verplicht): naam van de QR-code, max. 255 tekens.
to (verplicht): begunstigde, verschijnt in de bank-app van je klant, max. 255 tekens.
amount (verplicht): bedrag in euro, minimaal 0,01.
iban (verplicht): geldige IBAN. Spaties zijn toegestaan en worden automatisch genormaliseerd.
message (optioneel): mededeling, max. 35 tekens volgens de SEPA-tekenset. Laat je dit veld weg, dan wordt de titel gebruikt.

Antwoord (201 Created)

{
  "data": {
    "id": 123,
    "title": "Lidgeld 2026",
    "to": "KSK Voorbeeld",
    "amount": 25.00,
    "iban": "BE68539007547034",
    "message": "Lidgeld Jan Peeters",
    "image_url": "https://app.getpresto.be/api/v1/qr-codes/123/image",
    "created_at": "2026-07-14T10:00:00+00:00"
  }
}

Gebruik de image_url om de PNG rechtstreeks op te halen, of roep GET /qr-codes/{id}/image aan.

QR-codes ophalen

GET /qr-codes geeft een lijst van je QR-codes terug onder de sleutel data.
GET /qr-codes/{id}/image geeft de PNG-afbeelding terug (content-type image/png).

Foutcodes

401: sleutel ontbreekt, is ongeldig of werd ingetrokken.
403: geen actief Presto Pro-abonnement.
404: QR-code niet gevonden.
422: validatiefout, bijvoorbeeld een ongeldige IBAN of een te lange mededeling.

Een foutantwoord bevat een error-veld met uitleg. Bij validatiefouten (422) krijg je de betrokken velden terug.

Rate limiting

Je kan tot 60 aanvragen per minuut per sleutel versturen.