---
title: "Generate a self-service bill payment link token"
method: POST
path: "/bill-payments/self-service-link"
tags: ["Bill Payments"]
---

# Generate a self-service bill payment link token

`POST /bill-payments/self-service-link`

## Request

- The document declares no server URL.
- Auth: none declared. Required headers: `ApiKey`, `MerchantId`, `Environment`

## Headers

- `ApiKey` string, required
- `MerchantId` string, required
- `Environment` 'live' | 'sandbox', required

## Response `201`

- SelfServiceLinkDto
  - `token` string, required: Signed, opaque token identifying this merchant. Expires 24h after creation. Append it to the click-and-pay self-service base URL: {baseUrl}/self-service/{token}.

## Other responses

- `401`: Wrong credentials
- `403`: Forbidden
- `404`: Not Found
- `429`: ThrottlerException: Too Many Requests
- `500`: Internal error
- `503`: Service unavailable

## Changes

- **2026-11-03** `f6d3f87df5e0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hub2/apis/hub2-service-api/changes/bill-payments/self-service-link/post.md)

---

[API](https://skmtc.dev/hub2/apis/hub2-service-api.md) - [All operations](https://skmtc.dev/hub2/apis/hub2-service-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hub2/apis/hub2-service-api/revisions/f6d3f87df5e0?raw)