Transaction limits

Transaction limits allow you to specify spend controls on the card. All transaction limits are set in a single currency with the transaction being converted to this control currency in realtime. You can select from a number of base currencies to configure transaction limits.

Your account settings will also determine how the transaction limits are applied. See Account settings.

Account settings

Airwallex also allows you to set default transaction limits for a transaction, which are used if you do not specify transaction limits when creating or updating a card.

Use Get issuing config API to retrieve spending limit settings for a transaction for all supported base currencies. The response will return the per transaction limits for each currency in the following fields:

currency: The currency applicable to the transaction limit.
default: This limit is used if you do not specify a spending limit amount when creating or updating a card.
maximum: The maximum spending limit amount that you can set for a card. If you exceed this amount when creating or updating a card, the request will be rejected.

To update your default and maximum spending limits, contact your Airwallex Account Manager.

Shell

Example request

JSON

Example response

Apply transaction limits

You can apply transaction limits based on your default account settings. Transaction limits are supported for the following intervals through authorization_controls.transaction_limits.intervals field:

PER_TRANSACTION: Allows you to specify the maximum spend amount for an authorization transaction in a given currency. This is especially useful when you set up single-use cards for specific payments.
DAILY: Allows you to specify the maximum spend amount for a day, starting at midnight UTC.
WEEKLY: Allows you to specify the maximum spend amount for a week, starting on Sunday at midnight UTC.
MONTHLY: Allows you to specify the maximum spend amount for a month, starting on the 1st of the month.
QUARTERLY: Allows you to specify the maximum spend amount for a quarter, starting on the 1st day of the quarter.
YEARLY: Allows you to specify the maximum spend amount for a year, starting on the 1st day of the year.
ALL_TIME: Allows you to specify the maximum spend amount on all transactions during the active period.

You can check the remaining spend amount using the Get card remaining limits API endpoint. The remaining limits are calculated as follows:

Card debits such as authorizations and purchases are deducted from the transaction limits when the debit transaction is processed.
Card credits such as authorization releases, reversals, refunds and merchant credits are restored to the transaction limits when the credit transaction is processed.