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