---
title: "Create payment limit"
method: POST
path: "/governance/v1/limits"
tags: ["Fiat Payments"]
---

# Create payment limit

`POST /governance/v1/limits`

## Request

- Base URL: `https://api.sandbox.bvnk.com`
- URL: `https://api.sandbox.bvnk.com/governance/v1/limits`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/docs/governance/v1/limits/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a payment limit for a specific currency and payment method. Limits can be set at account level to control the maximum amount allowed per transaction or per day.

Supported limit types:

- `TRANSACTION`: Maximum amount for a single transaction.
- `DAILY`: Maximum cumulative amount across all transactions within a calendar day (based on the specified timezone).

With this endpoint you can also set limits for your customers by adding `customerId` to the payload.

## Request body

- CreatePaymentLimitRequest
  - `level` 'ACCOUNT' | 'ALL_CUSTOMERS' | 'CUSTOMER', required: The level at which the limit is applied. - `ACCOUNT` applies to the partner account only. - `ALL_CUSTOMERS` applies to all underlying customers. - `CUSTOMER` applies to a specific customer (requires `customerId`).
  - `customerId` string, uuid: The unique identifier of the customer the limit applies to. Required when you set limits for your customers, i.e., `level` is `CUSTOMER`.
  - `method` 'SEPA' | 'SEPA_INSTANT' | 'SWIFT' | 'FASTER_PAYMENT' | 'ACH' | 'FEDWIRE' | 'FEDNOW' | 'RTP', required: The payment method the limit applies to. Available methods depend on the selected currency: - **EUR**: `SEPA`, `SEPA_INSTANT`, `SWIFT` - **GBP**: `FASTER_PAYMENT` - **USD**: `ACH`, `FEDWIRE`, `FEDNOW`, `RTP`, `SWIFT` For more information, refer to [Payment schemes](/bvnk/references/payment-methods/)
  - `limitType` 'TRANSACTION' | 'DAILY', required: The type of limit to apply.
  - `amount` string, required: The limit amount in major currency units.
  - `currency` 'USD' | 'EUR' | 'GBP', required: Three-letter ISO-4217 currency code.
  - `zoneOffset` string: The UTC timezone offset used to determine the start and end of a calendar day for `DAILY` limits. Use the format `±HH:MM`. Optional. Default is `+00:00` (UTC) if not provided.

## Response `201`

Payment limit created successfully

- PaymentLimitResponse
  - `id` string, uuid: The unique identifier of the created payment limit.
  - `createdAt` string, date-time: The timestamp when the payment limit was created.
  - `updatedAt` string, date-time: The timestamp when the payment limit was last updated.

## Other responses

- `400`: Bad request
- `403`: Forbidden

## Changes

- **2026-11-06** `c386d436bf2c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/changes/governance/v1/limits/post.md)

---

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