---
title: "Create a payment link"
method: POST
path: "/api/v1/payment-link/"
tags: ["Payment Link"]
---

# Create a payment link

`POST /api/v1/payment-link/`

Create a payment link

## Request body

- PaymentLinkCreate
  - `product_id` string, required
  - `external_id` string, nullable — An external ID to identify a user. It can be the merchant's user ID or other tracking ID
  - `concept` string, nullable — Concept associated with the payment link. This text will be reflected as a concept in the bank issuing the payment
  - `currency` string — Currency associated with the amount of the payment link
  - `amount` string, decimal, nullable — Amount to be charged to a payment link
  - `expires_at` string, date-time, nullable — Date the payment link will expire
  - `email` string, email, nullable — Email of the user that created the payment link
  - `reusable` boolean — If the payment link can be used multiple times
  - `callback_url` string, url, nullable — URL to be called when the payment link status changes - **(SOON)**
  - `redirect_url` string, url, nullable — URL to redirect the user after the payment link is paid - **(SOON)**

## Response `201`

Payment link created

- PaymentLinkCreateResponse
  - `id` string, required
  - `url` string, required
  - `expires_at` string, date-time, nullable — Date the payment link will expire
  - `qr_code` string, nullable — Payment link qr code

## Other responses

- `400` — Bad request (some invalid field)

---

[API](https://skmtc.net/prometeoapi/apis/account-validation-v2.md) · [All operations](https://skmtc.net/prometeoapi/apis/account-validation-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/prometeoapi/account-validation-v2/versions/9c278fe91cbd/schema)