B2B Virtual Account Payment Method Codes

Refer back to the API Reference Page, for API specifications on the B2B Virtual Account Method APIs. 

Navigate to the documentation page for more exhaustive information about the B2B Virtual Accounts Payment Method APIs. 

Rules and Overrides for Request Virtual Account and Manage Payment Controls

This table lists the Rules and Overrides for Request Virtual Account and Manage Payment Controls for Visa Payment Controls.

Rules and Overrides for Request Virtual Account and Manage Payment Controls
SL No. Rule Code Rule Description Override Override Code Override Value
1 ATM Block ATM cash withdrawals. N n/a n/a
2 ATML Block ATM cash withdrawals above a threshold. Y amountCurrencyCode ISO Currency Code
amountValue Amount
3 PUR Block Purchases above a threshold. Y amountCurrencyCode ISO Currency Code
amountValue Amount
4 ECOM Block all Internet-based transactions. N n/a n/a
5 EAM Block all Internet based transactions above a threshold. Y amountCurrencyCode ISO Currency Code
amountValue Amount
6 CNP Block all transactions made over the Internet, phone or mail order. N n/a n/a
7 NOC Block all other cash access. This includes non-ATM transactions such as cash advances and purchase with cashback. N n/a n/a
8 ADT Block purchases at adult-themed merchants. N n/a n/a
9 XBR All purchases outside of the United States will be blocked. N n/a n/a
10 XBRA Purchases with amounts greater than the defined amount will be declined when conducted outside of the United States (enter whole dollar amount). Y amountCurrencyCode ISO Currency Code
amountValue Amount
11 DOM Purchases conducted outside of the selected state will be blocked Y cardAcceptorState or ProvinceCode Numeric code from lookup
12 BUS Check the box to block transactions conducted outside of business hours. Define the business hours, when transactions are ALLOWED, by selecting your local time zone and the days/times below. Transactions outside these hours will be blocked.   timezone


Eastern Time Zone/Central Standard Time/
Mountain Standard Time/Pacific Standard Time
  weekDayEffective

SUN/MON/TUE/WED/THU/FRI/SAT

Follow above - enter  3 letters with all caps  

  timeEffectiveStart HH:mm
  timeEffectiveEnd HH:mm
13 FUEL Block purchases conducted at fuel/driver merchants (including gas stations,car washes, parking lots and tolls). N n/a n/a
14 NOTFUEL Block purchases for all merchants except FUEL.. N n/a n/a
15 HOT All purchases made at hotel merchants will be declined. N n/a n/a
16 AUTO All purchases made at auto-rental merchants will be declined. N n/a n/a
17 AIR All purchases made at airline merchants will be declined. N n/a n/a
18 REST All purchases made at restaurants will be declined. N n/a n/a
19 JEWL All purchases made at jewelery store locations will be declined N n/a n/a
20 ELEC All purchases conducted at electronics themed-merchants will be declined. N n/a n/a
21 ALC All purchases conducted at alcohol and tobacco merchants will be declined. N n/a n/a
22 GTM All purchases conducted at ground transportation merchants will be declined (includes taxis, trains, and bridge tolls). N n/a n/a
23 OSS All purchases conducted at office supply merchants will be declined. N n/a n/a
24 GROC All purchases conducted at grocery store and pharmacy merchants will be declined. N n/a n/a
25 ENT All purchases conducted at entertainment and sports merchants will be declined (includes movie theaters,music stores and sporting good stores). N n/a n/a
26 UTIL All purchases conducted at utilities will be declined (includes cable, phone and electric companies). N n/a n/a
27 CLOTH All purchases conducted at clothing and general retail merchants will be declined(includes department stores, shoe stores and book stores). N n/a n/a
28 MED All purchases made at medical merchants will be declined. N n/a n/a
29 VPAS Exact amount match rule. Y amountCurrencyCode ISO Currency Code
amountValue Amount
30 CAID Card Acceptor ID tolerance Y CAIDValue Card Acceptor id value - Numeric (up to 15 digits)
31 TOLRNC Tolerance Rule Y amountCurrencyCode  ISO Currency Code
minValue  Amount
maxValue Amount
32 SPV

Spend Velocity Rule

Note: Override codes marked with an asterisk * are required.

Y SpendLimitAmount* Amount ; the maximum spend limit that will be allowed  Note: this is based on the range criteria selected.  I.e. if monthly is selected, it will reset every month to the SpendLimitAmount.
maxAuth Number ; if left blank it defaults to unlimited number of authorizations to reach SpendLimitAmount
amountCurrencyCode * ISO Currency Code ; the currency code for SpendLimitAmount
rangeType* 

Numeric value representing following: 1 - recurring, 2- monthly and 3- date range.
Based on selection, additional fields may be required:

  1. Recurring day - enter calendar day of  month. Format: numeric.
  2. Monthly - defaults to the first day of the month
  3. Data range - enter start date and end date. Format: mm/dd/yyyy
Notes:

 

  • Recurring day and Monthly - The SPV never expires.   It resets either on the date selected in the month or on the first of the month. 
  • Date range - The SPV is only valid for specified date range.       
updateFlag*

Potential values include:

  • NOCHANGE: enable the SPV rule the first time
  • UPDATE: update to an existing SPV keeping transaction details.
  • REPLACE: update existing SPV rule and removing transaction details (removing accruals).

Rules and Overrides for Virtual Card Requisition

This table lists the Rules and Overrides for Virtual Card Requisition for Visa Payment Controls.

Rules and Overrides for Virtual Card Requisition
SL No. Rule Code Rule Description Override Override Code Override Value
1 ATM Block ATM cash withdrawals. N n/a n/a
2 ATML Block ATM cash withdrawals above a threshold. Y amountCurrencyCode ISO Currency Code
amountValue Amount
3 PUR Block Purchases above a threshold. Y amountCurrencyCode ISO Currency Code
amountValue Amount
4 ECOM Block all Internet-based transactions. N n/a n/a
5 EAM Block all Internet based transactions above a threshold. Y amountCurrencyCode ISO Currency Code
amountValue Amount
6 CNP Block all transactions made over the Internet, phone or mail order. N n/a n/a
7 NOC Block all other cash access. This includes non-ATM transactions such as cash advances and purchase with cashback. N n/a n/a
8 ADT Block purchases at adult-themed merchants. N n/a n/a
9 XBR All purchases outside of the United States will be blocked. N n/a n/a
10 XBRA Purchases with amounts greater than the defined amount will be declined when conducted outside of the United States (enter whole dollar amount). Y amountCurrencyCode ISO Currency Code
amountValue Amount
11 DOM Purchases conducted outside of the selected state will be blocked. Y cardAcceptorState or ProvienceCode Numeric code from lookup
12 BUS Check the box to block transactions conducted outside of business hours. Define the business hours, when transactions are ALLOWED, by selecting your local time zone and the days/times below. Transactions outside these hours will be blocked.   timezone


Eastern Time Zone/Central Standard Time/
Mountain Standard Time/Pacific Standard Time
  weekDayEffective SUN/MON/TUE/WED/THU/FRI/SAT
  timeEffectiveStart HH:mm:ss
  timeEffectiveEnd HH:mm:ss
13 FUEL Block purchases conducted at fuel/driver merchants (including gas stations,car washes, parking lots and tolls). N n/a n/a
14 NOTFUEL Block purchases for all merchants except FUEL. N n/a n/a
15 HOT All purchases made at hotel merchantswill be declined. N n/a n/a
16 AUTO All purchases made at auto-rental merchants will be declined. N n/a n/a
17 AIR All purchases made at airline merchants will be declined. N n/a n/a
18 REST All purchases made at restaurants will be declined. N n/a n/a
19 JEWL All purchases made at jewelery store locations will be declined. N n/a n/a
20 ELEC All purchases conducted at electronics themed-merchants will be declined. N n/a n/a
21 ALC All purchases conducted at alcohol and tobacco merchants will be declined. N n/a n/a
22 GTM All purchases conducted at ground transportation merchants will be declined (includes taxis, trains, and bridge tolls). N n/a n/a
23 OSS All purchases conducted at office supply merchants will be declined. N n/a n/a
24 GROC All purchases conducted at grocery store and pharmacy merchants will be declined. N n/a n/a
25 ENT All purchases conducted at entertainment and sports merchants will be declined (includes movie theaters,music stores and sporting good stores). N n/a n/a
26 UTIL All purchases conducted at utilities will be declined (includes cable, phone and electric companies). N n/a n/a
27 CLOTH All purchases conducted at clothing and general retail merchants will be declined(includes department stores, shoe stores and book stores). N n/a n/a
28 MED All purchases made at medical merchants will be declined. N n/a n/a
29 VPAS Exact amount match rule. Y amountCurrencyCode ISO Currency Code
amountValue Amount

Rules and Overrides for Request Virtual Account for TSYS VPP

The following table lists rules and overrides for buyers enabled for VANs. See B2B Virtual Account Payment Method for Buyers Using VANs to view a full description of the VPP program applicable for buyers using VANs. 

Note: The merchant category rules for buyers using VANs are opt-in rules.  If one is selected, only the merchants that meet that criteria will be able to take a payment.

Request Virtual Account Rules and Overrides for TSYS VPP
SL No Rule Code  Rule Description  Override  Override Code  Override Value  Comments
SPV  Spend Velocity Rule  Y amountCurrencyCode  ISO Currency Code  The startDate and endDate must be in Eastern Standard Time (EST).
spendLimitAmount  Amount 
maxAuth  Number
startDate MM/DD/YYYY or YYYY-MM-DD
endDate MM/DD/YYYY or YYYY-MM-DD
VPAS  Exact Amount Match Rule  amountCurrencyCode  ISO Currency Code   
amountValue  Amount 
TOLRNC  Tolerance Rule  amountCurrencyCode  ISO Currency Code   
minValue  Amount 
maxValue  Amount 
DOM  Purchases conduted outside of the selected state will be enabled.  cardAcceptorState or ProvinceCode  ISO USA State Code  State code is valid for USA (840) country code 
CountryCode  ISO Country Code   
BUS  Check the box to block transactions conducted outside of business hours. Define the business hours, when transactions are ALLOWED, by selecting your local time zone and the days/times below. Transactions outside these hours will be blocked.   timezone  Eastern Time Zone/Central Standard Time/Mountain Standard Time/Pacific Standard Time note: weekDayEffective is case sensitive 
weekDayEffective  Sunday/Monday/Tuesday/Wednesday/Thursday/Friday/Saturday
timeEffectiveStart  HH:mm:ss
timeEffectiveEnd  HH:mm:ss
ATM  Enable ATM cash withdrawals.  n/a  n/a  
ECOM  Enable all Internet-based transactions.  n/a n/a  
CNP  Enable Card Not Present.  n/a  n/a  
FUEL 

Allow purchases conducted at fuel/driver merchants.

Allowed MCC Range: 5541 - 5542, 7542 - 7542.

n/a n/a  
10  AUTO 

Allow purchases made at auto-rental merchants.

Allowed MCC Range: 3351-3441, 7512-7512.

n/a n/a  
11  AIR 

Allow purchases made at airline merchants.

Allowed MCC Range: 3000-3300, 4511-4511.

n/a n/a  
12  REST 

Allow purchases made at restaurants.

Allowed MCC Range: 5811-5812, 5814-5815, 5462-5463.

n/a n/a  
13  ELEC 

Allow purchases conducted at electronics themed-merchants.

Allowed MCC Range : 4812-4814, 4816-4817, 5044-5045, 5731-5732, 5734-5734, 7372-7379.

n/a n/a  
14  ALC 

Allow purchases at alcohol and tobacco merchants.

Allowed MCC Range: 5813-5813, 5921-5922.

n/a n/a  
15  GTM 

Allow purchases conducted at ground transportation merchants will be declined (includes taxis, trains, and bridge tolls).

Allowed MCC Range:4011-4112, 4121-4131, 4784-4784.

n/a n/a  
16  OSS 

Allow purchases conducted at office supply merchants.

Allowed MCC Range: 5111-5112, 5943-5943, 7332-7361, 7392-7399 and 9402-9403.

n/a n/a  
17  GROC 

Allow purchases conducted at grocery store and pharmacy merchants.

Allowed MCC Range: 5411-5461, 5464-5499.

n/a n/a  
18  ENT 

Allow purchases conducted at entertainment and sports merchants(includes movie theaters,music stores and sporting good stores).

Allowed MCC Range: 7832-7994, 7996-7999.

n/a n/a  
19  UTIL 

Allow purchases at utilities (includes cable, phone and electric companies).

Allowed MCC Range: 4814-4815, 4899-4900.

n/a n/a  
20  MED 

Allow purchases made at medical merchants.

Allowed MCC Range: 4119-4119, 5975-5976, 8011-8099

n/a n/a  
21     PHAR 

Allow purchases made at Pharmacies.

Allowed MCC Range: 5122-5123, 5912-5913

n/a n/a  
22  GENR 

Allowed purchases made at General Retail.

Allowed MCC Range: 4225-4225, 5192-5410, 5611-5722, 5923-5942, 5944-5974 and 5977-5999

n/a n/a  
23  LODG 

Allow purchases made at Hotels, Motels, Resorts, Specific lodging establishment.s

Allowed MCC Range: 3501-3838, 7011-7011

n/a n/a  
24  OTHR  Other MCC codes  startRange  Allowed MCC between 0000-9999   
endRange  Allowed MCC value should be equal to or greater than startRange