Skip to content

Limits (Transaction Limits)

Transaction Limits - Check applicable transaction limits for customers.

Limit Types:

  • Transaction Limits: Minimum and maximum per transaction
  • Daily Limits: 24-hour rolling window
  • Weekly Limits: 7-day rolling window
  • Monthly Limits: 30-day rolling window
  • Annual Limits: 365-day rolling window

Limit Sources:

  • Provider Limits: Payment method/route specific limits
  • Customer Limits: User tier-based limits and overrides

Effective Limit: The most restrictive limit applies (minimum of provider and customer limits).

Use Cases:

  • Display available transaction amounts to customer
  • Validate transaction amount before submission
  • Show customer their current tier limits
  • Explain why a transaction amount is not allowed
Operations

Transaction Limits

Request

Returns applicable transaction limits for a given identity and transaction context.

Limits are derived from:

  • payment-provider limits (route/method specific), and
  • customer-specific limits (tier-based and/or overrides)

The response returns:

  • limits for DAILY/WEEKLY/MONTHLY/ANNUAL windows, including provider vs customer sources
Security
HMACAuth
Bodyapplication/jsonrequired
identityReferencestring, [ 1 .. 255 ] charactersrequired

Partner identity reference.

Example:"206-0x56c386b7b49be8618dbcdb2c6d09e161645c31ed"
methodstring, [ 1 .. 100 ] charactersrequired

The payment method.

Available payments
debit-credit-card
apple-pay
sepa-bank-transfer
gbp-bank-transfer
ach-bank-transfer
pix
zar-bank-transfer
interac-bank-transfer
ideal-bank-transfer
google-pay
payid-bank-transfer
wire-transfer
spei
pse
khipu
aud-bank-transfer
usd-bank-transfer
paypal
klarna-paynow
Example:"payid-bank-transfer"
transactionTypestringrequired

Transaction type (e.g., ONRAMP/OFFRAMP). Populate enum from your TransactionTypeEnum if desired.

Example:"ONRAMP"
fiatstring, [ 1 .. 10 ] characters^[A-Z0-9]{1,10}$required

Fiat currency code (typically ISO 4217).

Example:"AUD"
cryptostring, [ 1 .. 10 ] characters^[A-Z0-9]{1,10}$required

Crypto asset code.

Example:"BTC"
blockchainstring, [ 1 .. 50 ] charactersrequired

Blockchain identifier.

Example:"BTC"
curl -i -X POST \
  https://docs.banxa.com/_mock/products/native-api/openapi/eapi/v0/identities/transactions/limits \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "identityReference": "206-0x56c386b7b49be8618dbcdb2c6d09e161645c31ed",
    "method": "payid-bank-transfer",
    "fiat": "AUD",
    "crypto": "BTC",
    "blockchain": "BTC",
    "transactionType": "ONRAMP"
  }'

Responses

Limits result

Bodyapplication/json
identityReferencestringrequired

Echo of the identity reference.

Example:"206-0x56c386b7b49be8618dbcdb2c6d09e161645c31ed"
limitsobjectrequired
Response
Shows per-transaction and periodical limits from both provider and customer sources
{
  "identityReference": "RandomCustReferenceForTesting020600001",
  "limits": {
    "transaction": { … },
    "periodical": [ … ]
  }
}
© Banxa 2026