---
title: "PaymentLink:Create"
method: POST
path: "/services/{serviceId}/paymentlink"
tags: ["Services"]
---

# PaymentLink:Create

`POST /services/{serviceId}/paymentlink`

You can create a payment page for invoice payments & donations

## Path parameters

- `serviceId` Id, required — unresolved $ref

## Request body

- object — Create a PaymentLink
  - `securityMode` SecurityMode, required — unresolved $ref
  - `countryCode` CountryCode — unresolved $ref
  - `language` string, required — The language code supplied needs to be a locale in i18n format. The available languages can be retrieved with the Core Data API Languages (https://developer.pay.nl/reference/get_languages) where the hostedPaymentPageLanguageAvailable flag is set to 'True'
  - `amount` Amount, required
    - `value` integer, required — The amount in cents.
    - `currency` string — The currency in ISO-4217 format.
  - `amountMin` Amount, required
    - `value` integer, required — The amount in cents.
    - `currency` string — The currency in ISO-4217 format.
  - `stats` Stats
    - `info` string — The used info code which can be tracked in the stats.
    - `tool` string — The used tool code which can be tracked in the stats.
    - `object` string — The object which can be tracked in stats.
    - `extra1` string — The first free value which can be tracked in the stats.
    - `extra2` string — The second free value which can be tracked in the stats.
    - `extra3` string — The third free value which can be tracked in the stats.
    - `domainId` string — The ID of the duplicate content URL

## Response `200`

Ok.

- PaymentLink
  - `url` string, uri — The paylink url.
  - `securityMode` 0 | 1 | 2 | 3, required — 0: URL, amount and variables can be changed 1: Amount is fixed. URL and variables can be changed 2: Pre filled variable can be changed. Amount is fixed 3: URL, amount and variables are fixed. Only empty variables can be filled

## Other responses

- `400` — Bad request, see response body for more information
- `401` — Unauthorized. Supplied credentials are invalid
- `403` — Forbidden. Supplied credentials have no rights
- `405` — Used HTTP method is not allowed
- `406` — Not acceptable. The supplied content type in the accept parameter in the header is not supported
- `422` — Unprocessable entity, see response body for more information
- `429` — Rate limit reached.
- `500` — An internal error occurred

---

[API](https://skmtc.dev/pay/apis/pay-transaction-gateway-unit-api.md) · [All operations](https://skmtc.dev/pay/apis/pay-transaction-gateway-unit-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pay/pay-transaction-gateway-unit-api/revisions/2bc260c7bdfc/schema)