BVbvnk
Fiat Payments

Create payment limit

Changed on

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.

post/governance/v1/limits

Request

Request body

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).
customerIdstring 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

limitType'TRANSACTION' | 'DAILY' required

The type of limit to apply.

amountstring required

The limit amount in major currency units.

currency'USD' | 'EUR' | 'GBP' required

Three-letter ISO-4217 currency code.

zoneOffsetstring

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.

Example request

{
  "level": "ACCOUNT",
  "customerId": "b7c3e1a2-8f4d-4a6e-9c12-3d5f7a8b9e01",
  "method": "SWIFT",
  "limitType": "TRANSACTION",
  "amount": "10000",
  "currency": "EUR",
  "zoneOffset": "+00:00"
}

Response

Payment limit created successfully

idstring uuid

The unique identifier of the created payment limit.

createdAtstring date-time

The timestamp when the payment limit was created.

updatedAtstring date-time

The timestamp when the payment limit was last updated.

Example response

{
  "id": "fa2f29ca-fa0e-421b-86b6-4eb415d2933c",
  "createdAt": "2026-07-03T12:20:53.276599438Z",
  "updatedAt": "2026-07-03T12:20:53.330993Z"
}

Changes