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

# Referentie betaallinks

> Referentie voor storekit-betaallinks: linktypes, prijsmodi, statussen, transactiestatussen, aanmaakvelden, klantveldmodi, ID's, MCP-tools en webhook-events.

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](/docs/nl/payment-links/managing-payment-links#statuses).

## 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](/docs/nl/payment-links/refunds-and-transactions).

## 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](/docs/nl/payment-links/collecting-for-an-order) |
| `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](/docs/nl/developers/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](/docs/nl/developers/webhooks/webhook-events#payments-events).


## Related topics

- [Betaallinks beheren](/docs/nl/payment-links/managing-payment-links.md)
- [Terugbetalingen en transacties voor betaallinks](/docs/nl/payment-links/refunds-and-transactions.md)
- [Een betaallink aanmaken](/docs/nl/payment-links/creating-a-payment-link.md)
- [Overzicht betaallinks](/docs/nl/payment-links/overview.md)
- [Een betaallink delen](/docs/nl/payment-links/sharing-a-payment-link.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.