Referentie betaallinks

Snelzoekgids voor de termen die in de betaallinks-gidsen worden gebruikt. Voor hoe-doe-ik-detail volg je de links in elk gedeelte.

Linktypes

Dashboard-label	Gedrag	API-waarde
One-off	Sluit na één geslaagde betaling	`one_off`
Reusable	Blijft open totdat gedeactiveerd, verlopen of de betaallimiet is bereikt	`reusable`

Vastgelegd bij aanmaken.

Prijsmodi

Dashboard-label	Gedrag	API-waarde
Set price	Klant betaalt de Price die je invoert	`fixed`
Customer chooses	Klant voert een bedrag in, eventueel binnen Minimum en Maximum	`variable`

Vastgelegd bij aanmaken. Minimum en Maximum kunnen achteraf worden bewerkt.

Linkstatussen

Status	Hoe een link hier komt	Kan het worden gewijzigd?
Active	Aangemaakt, of geheractiveerd met Activate	Deactivate
Inactive	Deactivate	Activate
Expired	Link expiry date verstreken	Nee — maak een nieuwe link aan
Completed	One-off link betaald, of reusable link heeft Maximum number of payments bereikt	Nee — maak een nieuwe link aan

Details in Betaallinks beheren.

Transactiestatussen

Status	Betekenis	Terugbetaalbaar?
Pending	Betaling gestart, nog niet bevestigd	Nee
Paid	Betaling geslaagd	Ja
Partial Refund	Deel van de betaling terugbetaald	Ja, tot Max refundable
Refunded	Volledig terugbetaald	Nee

Details in Terugbetalingen en transacties.

Aanmaakvelden

Labels zoals getoond op de New Payment Link-pagina. De detailpagina gebruikt kortere labels voor dezelfde velden, tussen haakjes weergegeven waar ze verschillen.

Veld	Verplicht	Later bewerkbaar
Store	Ja	Nee
Title	Ja	Ja
Description shown to the customer (Description)	Nee	Ja
Link type (Link Type)	Ja	Nee
Pricing (Amount Type)	Ja	Nee
Price	Met Set price	Nee
Minimum / Maximum (Min Amount / Max Amount)	Nee	Ja
Image	Nee	Ja
Customer fields — Name, Email, Phone, Business name	Nee	Ja
Reference	Nee	Ja
Link expiry date (Expiry Date)	Nee	Ja
Maximum number of payments (Max Payments)	Nee, alleen reusable	Ja
After successful payment (After Payment)	Ja, standaard Show thank you	Ja
Custom thank you message (Success Message)	Nee	Ja
Redirect URL after payment (Redirect URL)	Met Redirect to URL	Ja

Klantveldmodi

Dashboard-label	Gedrag op de checkout-pagina	API-waarde
Off	Veld niet getoond	`disabled`
Optional	Getoond, gemarkeerd optional	`optional`
Required	Getoond, moet worden ingevuld om te betalen	`required`

De vier velden verwijzen naar collectCustomerName, collectEmail, collectPhone en collectBusinessName.

Waar links vandaan komen

De detailpagina toont Created via voor elke link:

Waarde	Aangemaakt door
`dashboard`	Payment Links → Create Payment Link
`order`	De Send Payment Link-prompt op een bestelling. Zie Betaling innen voor een onbetaalde bestelling
`mcp`	Een AI-assistent gekoppeld via storekit MCP
`api`	Directe API-integratie

Betaallink-ID’s

Elke betaallink heeft een ID met het voorvoegsel plink_, bijvoorbeeld plink_019dbc4d828174419d9ff9fae24aea7b. Hij verschijnt in de dashboard-URL wanneer de link is geopend, in MCP-toolreacties en in webhook-payloads, en hij is het laatste deel van de klant-URL: https://<jouw besteldomein>/pay/plink_….

Developers

MCP-tools

Gekoppelde AI-assistenten gebruiken deze tools; zie MCP-tools voor parameters.

Tool	Type
`list-payment-links`	Read
`get-payment-link`	Read
`create-payment-link`	Write — de assistent vraagt om goedkeuring tenzij je hem hebt auto-toegestaan
`get-payment-link-qr`	Read — retourneert een PNG

Webhook-events

Event	Wordt geactiveerd wanneer
`payment_link.created`	Een betaallink wordt aangemaakt
`payment_link.paid`	Een betaling wordt via een link geïnd
`payment_link.refund.created`	Een terugbetaling wordt aangevraagd
`payment_link.refund.succeeded`	De betaalprovider bevestigt de terugbetaling
`payment_link.refund.failed`	De betaalprovider weigert de terugbetaling

Payloads worden gedocumenteerd in Webhook-events.

​Linktypes

​Prijsmodi

​Linkstatussen

​Transactiestatussen

​Aanmaakvelden

​Klantveldmodi

​Waar links vandaan komen

​Betaallink-ID’s

​Developers

​MCP-tools

​Webhook-events