---
title: "Create Paymentlinks"
method: POST
path: "/api/v1/paymentlinks/"
tags: ["Payment Links"]
---

# Create Paymentlinks

`POST /api/v1/paymentlinks/`

Payment links API

## Request body

- PaymentLinksSer
  - `id` string, uuid
  - `title` string, required — Payment link title
  - `is_active` boolean
  - `redirect_url` string, uri, nullable — Optional website URL to redirect the client after a successful payment
  - `amount` integer
  - `usage_limit` integer
  - `qrcode_file` string, uri, nullable, required
  - `url` string, required
  - `currency` 'KES' | 'GHS' | 'NGN' | 'UGX' | 'TZS' | 'XAF' | 'XOF' — Supported currencies: - `KES` - Kenyan Shilling (KE) - `GHS` - Ghanaian Cedi (GH) - `NGN` - Nigerian Naira (NG) - `UGX` - Ugandan Shilling (UG) - `TZS` - Tanzanian Shilling (TZ) - `XAF` - Central African CFA Franc (CM) - `XOF` - West African CFA Franc (BF, CI)
  - `mobile_tarrif` 'BUSINESS-PAYS' | 'CUSTOMER-PAYS' — * `BUSINESS-PAYS` - Business Pay Charges * `CUSTOMER-PAYS` - Customer Pay Charges
  - `card_tarrif` 'BUSINESS-PAYS' | 'CUSTOMER-PAYS' — * `BUSINESS-PAYS` - Business Pay Charges * `CUSTOMER-PAYS` - Customer Pay Charges
  - `created_at` string, date-time, nullable, required
  - `updated_at` string, date-time, nullable, required

## Response `201`

- PaymentLinksSer
  - `id` string, uuid
  - `title` string, required — Payment link title
  - `is_active` boolean
  - `redirect_url` string, uri, nullable — Optional website URL to redirect the client after a successful payment
  - `amount` integer
  - `usage_limit` integer
  - `qrcode_file` string, uri, nullable, required
  - `url` string, required
  - `currency` 'KES' | 'GHS' | 'NGN' | 'UGX' | 'TZS' | 'XAF' | 'XOF' — Supported currencies: - `KES` - Kenyan Shilling (KE) - `GHS` - Ghanaian Cedi (GH) - `NGN` - Nigerian Naira (NG) - `UGX` - Ugandan Shilling (UG) - `TZS` - Tanzanian Shilling (TZ) - `XAF` - Central African CFA Franc (CM) - `XOF` - West African CFA Franc (BF, CI)
  - `mobile_tarrif` 'BUSINESS-PAYS' | 'CUSTOMER-PAYS' — * `BUSINESS-PAYS` - Business Pay Charges * `CUSTOMER-PAYS` - Customer Pay Charges
  - `card_tarrif` 'BUSINESS-PAYS' | 'CUSTOMER-PAYS' — * `BUSINESS-PAYS` - Business Pay Charges * `CUSTOMER-PAYS` - Customer Pay Charges
  - `created_at` string, date-time, nullable, required
  - `updated_at` string, date-time, nullable, required

---

[API](https://skmtc.dev/intasend/apis/intasend-api.md) · [All operations](https://skmtc.dev/intasend/apis/intasend-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/intasend/intasend-api/revisions/9fd63286a2c8/schema)