Search...
APIJSLog inGet started
Airwallex logo
Home
Platform APIs
Connected Accounts
Accounts
Payments
Transactional FX
Payouts
Issuing
Back to home
OverviewHow Airwallex Issuing worksSupported regions and currenciesSupported card programs
Use Cases
Card controls
Authorization controls
Transaction limitsBlocked Transaction Usage Scopes
Remote authorization
3D Secure authentication
Troubleshooting

Blocked Transaction Usage Scopes

Blocked transaction usage scopes allow you to specify transaction and usage scopes on the card. This feature allows users to configure controls during the card creation process or modify them at any time afterward.

Account Settings

Specific regions may have default blocked transaction usages due to regulatory reasons.

Use Get issuing config API to retrieve the default blocked transaction usages on an account level. The response will return the default values for the following fields:

  • transaction_scope: Types of transaction scope. It can be one of: ALL_TRANSACTIONS, ONLINE_TRANSACTION, CONTACTLESS_TRANSACTION, CONTACT_CHIP_TRANSACTION, MAGSTRIPE, CASH_WITHDRAWAL, BILL_PAYMENT, ACCOUNT_FUNDING.
  • usage_scope: Determines if a transaction can be made domestically and/or internationally. It can be one of: ALL, INTERNATIONAL, DOMESTIC.

To update your account default blocked transaction usages, contact your Airwallex Account Manager.

Shell
Example Request
JSON
Example Response

Available Transaction Scopes

Blocked transaction scopes support the following values through authorization_controls.blocked_transaction_usages.transaction_scope field:

  • ALL_TRANSACTIONS: Blocks all transactions.
  • ONLINE_TRANSACTION: Blocks card-not-present transactions where the card details are entered manually or stored digitally. Common scenarios are e-commerce purchases and digital payments.
  • CONTACTLESS_TRANSACTION: Blocks transactions made by tapping or waving the card near a payment terminal, includes Apple Pay and Google Pay.
  • CONTACT_CHIP_TRANSACTION: Blocks transactions where the card is inserted into the payment terminal.
  • MAGSTRIPE: Blocks transactions where the card's magnetic stripe is used.
  • CASH_WITHDRAWAL: Blocks ATM withdrawals.
  • BILL_PAYMENT: Blocks regular or one-time payment to service providers.
  • ACCOUNT_FUNDING: Blocks transactions that add money to the card's account.

Available Usage Scopes

Blocked usage scopes support the following values through authorization_controls.blocked_transaction_usages.usage_scope field:

  • DOMESTIC: Blocks all transactions within the card's issued country.
  • INTERNATIONAL: Blocks all transactions outside the card's issued country.
  • ALL: Blocks all transactions regardless of location.

Example: Setting usage_scope to INTERNATIONAL would block a US-issued card from being used in Canada, but allow it to be used within the US.

Below is an example of how to update the card to block all online transactions and international magnetic strip transactions.

Shell
Example Request