Transaction Minimum Amounts

Basqet enforces minimum transaction amounts for supported fiat checkout currencies. These minimums apply when you create or initialize transactions and when you create static payment links.

Minimums help prevent payments that are too small to process reliably after network costs, rate conversion, and settlement handling.

Current Minimums

Currency	Minimum Amount
`USD`	`1`
`NGN`	`2000`
`EUR`	`1`
`GBP`	`1`

Where Minimums Apply

Flow	Behavior
Initialize Transaction API	If you submit an amount below the currency minimum, Basqet rejects the request before creating the transaction.
Dashboard Payment Links	If you create a static payment link below the currency minimum, Basqet rejects it during link creation.
Payment Links API	If you create a static payment link below the currency minimum, Basqet rejects it during link creation.

Dynamic payment links do not set a fixed amount when you create the link. The minimum is enforced when your customer enters an amount and the transaction is initialized.

Example

For NGN, the minimum transaction amount is 2000.

{
  "currency": "NGN",
  "amount": "1500"
}

This request is rejected because 1500 is below the minimum allowed amount for NGN.

Use an amount of 2000 or higher:

{
  "currency": "NGN",
  "amount": "2000"
}

Error Handling

When an amount is below the configured minimum, Basqet returns a validation error similar to:

{
  "status": "error",
  "message": "Amount is below the minimum allowed for NGN (minimum: 2000)"
}

You should show a clear message to your customers and ask them to enter an amount equal to or greater than the minimum for the selected currency.

Notes

Minimums are evaluated against the fiat currency the transaction is priced in.
Amounts should be sent as numeric strings for transaction initialization, for example "2000".
For static payment links, the fixed link amount must meet the minimum for the selected currency.
For dynamic payment links, validate your customer's entered amount before attempting to initialize the transaction.