API-verkenner
API-verkenner

Theme switcher

Session Webhook

De Session Webhook stelt uw systeem op de hoogte wanneer een betalingssessie van status verandert.

Hierdoor kan uw platform in realtime reageren, bijvoorbeeld wanneer een sessie actief wordt, mislukt of verloopt.

Je kunt ook lezen hoe je de sessiewebhook kunt instellen of uitschakelen: Session Webhook Instellen | Session Webhook Uitschakelen

Wanneer het wordt geactiveerd

Status

Beschrijving

Typisch gebruiksscenario

session_active

De sessie is succesvol gestart en is momenteel actief.

De sessie is gestart en de klant gaat door met het betalingsproces.

cancelled

De klant heeft de sessie handmatig geannuleerd of het afrekenen afgesloten.

Stop met het volgen van de sessie en markeer deze als geannuleerd.

failed

De sessie is mislukt vanwege een technische fout of validatiefout (bijvoorbeeld betaalmethode niet beschikbaar, ongeldige gegevens).

Geef een foutmelding weer of registreer de fout voor een nieuwe poging.

session_expired

De sessie is automatisch verlopen na een time-out (1 uur) zonder dat het afrekenen is voltooid.

Sessie als verlopen markeren en gerelateerde lopende processen annuleren.

order_created

De afrekening is succesvol voltooid en er is een bestelling aangemaakt.

Bevestig de bestelling en start de afhandeling in uw systeem.

Voorbeeld payloads

Elke webhook gebruikt dezelfde payload-structuur. Alleen het statusveld verandert om de huidige sessiestatus aan te geven.

Parameters van de lading:

  • status — huidige sessiestatus
  • invoiceNumber — intern factuurnummer
  • transactionId — unieke transactie-identificatiecode
  • billinkInvoiceNumber — openbaar factuurnummer, gegenereerd door Billink op basis van factuurnummer

Voorbeeld: session_active

JSON
{
  "status": "session_active",
  "invoiceNumber": "invoice-1234",
  "transactionId": "tx_001a45",
  "billinkInvoiceNumber": "1ABinvoice-1234"
}

Voorbeeld: cancelled

JSON
{
  "status": "cancelled",
  "invoiceNumber": "invoice-1234",
  "transactionId": "tx_001a45",
  "billinkInvoiceNumber": "1ABinvoice-1234"
}

Voorbeeld: failed

JSON
{
  "status": "failed",
  "invoiceNumber": "invoice-1234",
  "transactionId": "tx_001a45",
  "billinkInvoiceNumber": "1ABinvoice-1234"
}

Voorbeeld: session_expired

JSON
{
  "status": "session_expired",
  "invoiceNumber": "invoice-1234",
  "transactionId": "tx_001a45",
  "billinkInvoiceNumber": "1ABinvoice-1234"
}

Voorbeeld: order_created

JSON
{
  "status": "order_created",
  "invoiceNumber": "invoice-1234",
  "transactionId": "tx_001a45",
  "billinkInvoiceNumber": "1ABinvoice-1234"
}

Levering en herhalingspogingen

Wanneer een webhook wordt geactiveerd, stuurt Billink een HTTPS POST-verzoek naar de door u geconfigureerde webhook-URL met de bijbehorende gebeurtenis-payload.

Als uw eindpunt reageert met HTTP 200-299, zal het systeem automatisch tot drie keer toe opnieuw proberen de levering uit te voeren:

Attempt

Delay before retry

1st opnieuw proberen

na 5 seconden

2nd opnieuw proberen

na 10 seconden

3rd opnieuw proberen

na 15 seconden

Na drie mislukte pogingen wordt de webhook als onbestelbaar beschouwd en worden er geen verdere pogingen meer ondernomen.

Om een succesvolle levering te garanderen:

  • Reageer altijd met HTTP 200 OK zodra uw systeem de webhook ontvangt.
  • Verwerk asynchroon om time-outs te voorkomen.
  • Log alle inkomende webhook-pogingen voor foutopsporing en afstemming.
Was this section helpful?

What made this section unhelpful for you?

On this page
  • Session Webhook