> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kaspert.be/llms.txt
> Use this file to discover all available pages before exploring further.

# Accepteer Payconiq by Bancontact in je Kaspert-webshop

> Schakel Payconiq by Bancontact QR-betalingen in voor webshopbestellingen en lidgelden, met automatische statusupdates van bestellingen.

Payconiq by Bancontact is een van de meest gebruikte mobiele betaalmethoden in Belgie. Klanten betalen in een oogwenk door een QR-code te scannen met hun bankapp. Kaspert integreert Payconiq als betaaloptie in je webshop en op het publieke inschrijvingsformulier voor lidgeld, zodat kopers hun betaling op hun telefoon kunnen afronden zonder creditcard of handmatige overschrijving.

## Waar Payconiq beschikbaar is in Kaspert

<CardGroup cols={2}>
  <Card title="Webshopbestellingen" icon="cart-shopping">
    Wanneer een koper een bestelling plaatst in je webshop en bij het afrekenen Payconiq selecteert, genereert Kaspert een QR-code die hij of zij kan scannen om te betalen. De bestelstatus wordt automatisch bijgewerkt naar **Betaald** zodra de betaling is bevestigd.
  </Card>

  <Card title="Lidgeld-betalingen" icon="users">
    Op het publieke inschrijvingsformulier kunnen ouders ervoor kiezen om het lidgeld onmiddellijk via Payconiq te betalen. Er is geen handmatige vervolgactie nodig. Kaspert markeert de betalingsverplichting als betaald zodra Payconiq dit bevestigt.
  </Card>
</CardGroup>

***

## Hoe een Payconiq-betaling werkt

<Steps>
  <Step title="Koper plaatst een bestelling">
    De koper vult het bestelformulier in op je publieke webshop-URL en selecteert **Payconiq** als betaalmethode voor de bevestiging.
  </Step>

  <Step title="QR-code wordt gegenereerd">
    Kaspert maakt via de Bancontact Pro API een Payconiq-betalingsverzoek aan voor het exacte bestelbedrag in euro. De koper ziet een QR-code op de bestelbevestigingspagina.
  </Step>

  <Step title="Koper scant en betaalt">
    De koper opent zijn bankapp (Payconiq, KBC Mobile, ING, Fintro, Hello Bank, enz.) en scant de QR-code. Op mobiel kan de koper ook op de **deeplink**-knop tikken om de app direct te openen zonder te scannen.
  </Step>

  <Step title="Kaspert ontvangt de betalingscallback">
    Nadat de koper de betaling in zijn app heeft goedgekeurd, stuurt Bancontact Pro een beveiligde callback naar de servers van Kaspert. Kaspert verifieert de betalingsstatus en het bedrag rechtstreeks via de Bancontact API voordat er data wordt bijgewerkt. De callback zelf wordt nooit blindelings vertrouwd.
  </Step>

  <Step title="Bestelling wordt als betaald gemarkeerd">
    Zodra de betaling is geverifieerd, werkt Kaspert de bestelstatus bij naar **Betaald**. De koper ontvangt een bestelbevestigingsmail, en de admin-melding (indien geconfigureerd) wordt verstuurd naar het adres dat is ingesteld in Beheer > Verkoop > E-mailsjabloon.
  </Step>

  <Step title="Koper wordt doorgestuurd">
    De bestelpagina ververst automatisch wanneer de betaling is bevestigd. De koper wordt doorgestuurd naar de bestelbevestigingspagina. Er is geen handmatige vernieuwing nodig.
  </Step>
</Steps>

***

## Betalingsvervaldatum

Een Payconiq-betalingsverzoek is **24 uur** geldig vanaf het moment dat de bestelling wordt aangemaakt. Als de koper niet binnen dat tijdsvenster scant en betaalt, vervalt het betalingsverzoek en de QR-code werkt niet meer. De koper kan terugkeren naar je webshop om een nieuwe bestelling te plaatsen.

<Info>
  Kaspert blokkeert het starten van betalingen voor bestellingen ouder dan 24 uur om misbruik te voorkomen. Als een koper contact opneemt over een verlopen QR-code, vraag hem of haar dan om een nieuwe bestelling te plaatsen.
</Info>

***

## Payconiq instellen voor je organisatie

Payconiq wordt op platformniveau geconfigureerd met de Bancontact Pro-handelaarsgegevens van je organisatie. In tegenstelling tot Stripe stel je dit niet zelf in via een selfservice-flow.

<Steps>
  <Step title="Neem contact op met Kaspert-support">
    Mail [**support@kaspert.be**](mailto:support@kaspert.be) en vraag om Payconiq-activatie voor je organisatie. Vermeld je organisatienaam en het e-mailadres van je admin-account.
  </Step>

  <Step title="Geef je Bancontact Pro API-sleutel door">
    Als je al een Bancontact Pro-handelaarsaccount hebt, deel dan je API-sleutel met het Kaspert-supportteam. Als je er nog geen hebt, kan Kaspert je begeleiden bij het registratieproces voor Bancontact Pro.
  </Step>

  <Step title="Payconiq verschijnt als betaaloptie">
    Zodra de configuratie is voltooid, verschijnt Payconiq als beschikbare betaalmethode wanneer je een nieuwe verkoop publiceert in Beheer > Verkoop en wanneer kopers afrekenen.
  </Step>
</Steps>

***

## Uitbetalingen

<Note>
  Payconiq-betalingen worden verwerkt via het Bancontact Pro-handelaarsaccount van Kaspert. Uitbetalingen naar de bankrekening van je organisatie worden apart afgehandeld en zijn niet automatisch op dezelfde manier als Stripe Connect-uitbetalingen. Neem contact op met [**support@kaspert.be**](mailto:support@kaspert.be) om het uitbetalingschema en het proces voor je organisatie te bespreken.
</Note>

***

## Betalingsstatussen

Kaspert koppelt de Bancontact Pro-betalingsstatussen aan de volgende interne statussen:

| Bancontact Pro-status   | Kaspert-bestelstatus | Betekenis                                     |
| ----------------------- | -------------------- | --------------------------------------------- |
| `SUCCEEDED` / `SUCCESS` | Betaald              | Betaling bevestigd en geverifieerd            |
| `FAILED`                | Onbetaald            | Betaling geweigerd of mislukt                 |
| `EXPIRED`               | Onbetaald            | QR-code verlopen zonder betaling              |
| `CANCELLED`             | Onbetaald            | Koper heeft de betaling geannuleerd in de app |
| `AUTHORIZATION_FAILED`  | Onbetaald            | Bank weigerde de autorisatie                  |

Voor de statussen `FAILED` en `AUTHORIZATION_FAILED` ontvangt het Kaspert-supportteam automatisch een melding. Er is geen actie van jouw kant vereist, maar je kunt wel zelf contact opnemen met de koper.