Data Dictionaries

envisso data fields the below table is a list of all fields in the envisso integration data element description format environment the environment this row of data has been pulled from in your system (production / testing) this enables envisso to ensure test files are never used for production purposes valid values are "production" or "testing" registered country the country code where the merchant legal entity was incorporated 2 letter (alpha 2) iso 3166 country code merchant registration id type the id type provided for the merchant registration id see merchant registration id details below for country specific details depends on registered country merchant registration id the identifier provided by the government body as part incorporation see merchant registration id details below for country specific details depends on registered country merchant legal name the legal name registered for the merchant at the point of incorporation merchant category code a 4 digit category code assigned based on iso 18245 4 digit numeric value based on iso 18245 billing descriptor a billing descriptor describes a payment and helps the cardholder identify the transaction on his or her bank statement url the link for the homepage of the merchants website merchant website url company registration date the registration/incorporation date when the merchant entity was registered with the relevant government agency also known as incorporation date dd/mm/yyyy trading currency the primary trading currency of the merchant 3 letter, iso 4217 currency code estimated annual tpv the estimated annual total payment value of the merchant for the next 12 months numeric value with no currency symbol the value should be in the currency identified by the trading currency field merchant trading name the name under which the merchant is trading / doing business as business description a general description of what the merchant is doing registered address the address the merchant is legally registered at as part of incorporation with the relevant government agency trading address the address the merchant is trading/doing business at director a company director is someone appointed, usually by the members (owners) of a company, to manage and run the company on their behalf ubo / ultimate beneficial owner a ubo or ultimate beneficial owner is the person that is the ultimate beneficiary when an institution initiates a transaction transaction date/time date & time of the transaction event dd mm yyyy hh\ mm\ ss transaction id unique id of each transaction this should match across funding and chargeback files authorisation id unique id of the authorisation event associated to a transaction this should match across authorisation and funding files payment method the payment method used for the transaction possible values are "credit card", "debit card", "applepay", "googlepay", "alipay" ,"qr code", "wallet", "bnpl" transaction type indicator of the transaction type being either a refund or purchase valid values are "purchase" & "refund" scheme mid the card scheme merchant id that is passed to the card network on the transaction card bin the first 6 digits of the card number 6 digit numeric input transaction currency the currency code associated to the transaction 3 letter, iso 4217 currency code transaction amount the amount of the transaction in the currency indicated in the transaction currency field numeric value with no currency symbol channel the payment channel which the transaction occurred valid values are "pos", "online" & "other" (note pos = point of sale) ip address the ip address used by the end customer on an online transaction ipv6 or ipv4 terminal id the terminal id used for a point of sale transaction authorisation date/time date & time of the authorisation event dd mm yyyy hh\ mm\ ss authorisation type the type of authorisation event being performed valid values are "authorisation" & "refund" authorisation status the status of the authorisation event valid values are "processed" & "declined" authorisation status reason the status reason for the authorisation being declined for processed authorisations, this can be null examples include "insufficient funds" & "invalid cvv" chargeback date/time date & time of the chargeback update event dd mm yyyy hh\ mm\ ss chargeback id the unique id associated to the chargeback event this id should be consistent throughout the chargeback lifecycle chargeback reason code the reason code associated to the chargeback see chargeback reason code table for more details chargeback status the status of the chargeback indicates what state the chargeback is currently in there are many statuses throughout the chargeback lifecycle, however for integration the mandatory inputs are the initial event (i e submitted) and the final event (i e settled or successfully defended") the status of the chargeback based on the latest event example values are "submitted", "settled" & "successfully defended" chargeback currency the currency code associated to the chargeback 3 letter, iso 4217 currency code chargeback amount the amount of the chargeback in the currency indicated in the chargeback currency field numeric value with no currency symbol merchant registration id details singapore name unique entity number merchant registration id type uen length 9 digits format sxxxxxxxxxx description the uen is a unique identifier for all businesses registered in singapore it simplifies business registration by eliminating the need for multiple registration numbers united kingdom name company registration number merchant registration id type companies house id length 8 digits (or 10 digits including prefix) format (optional prefix) 12345678 description assigned by companies house, this number identifies registered companies in the uk hong kong name business registration number merchant registration id type brn length 8 digits format 12345678 description the brn number is issued upon successful business registration in hong kong australia name business registration number (brn) mechant registration id type brn length 8 10 digits format 12345678 description the brn number is issued upon successful business registration in australia japan name corporation number merchant registration id type cn length 13 digits format xxxxxxxxx xxxx description this number identifies corporations registered with the legal affairs bureau in japan india name company identification number merchant registration id type cin length 21 characters format uxxxxxxxxxxinxxxxxxxx description the cin is a unique identifier assigned to companies registered under the companies act, 2013 malaysia name company registration number merchant registration id type crn length 9 digits format \[number] \[year of registration] (e g , 123456789 2023) description this number identifies companies registered with the companies commission of malaysia (ssm) new zealand name new zealand business number merchant registration id type nzbn length 13 digits format xxx xxxxxxx xx description the nzbn is a unique identifier for businesses registered in new zealand brazil name cadastro nacional da pessoa jurídica merchant registration id type cnpj length 14 digits format xx xxx xxx/xxxx xx the first eight digits identify the company itself the four digits after the slash (optional) identify a specific branch or subsidiary (0000 signifies the main headquarters) the last two digits are check digits for verification description the cnpj is the primary identification number for legal entities (companies) in brazil it serves as a unique identifier for tax, legal, and administrative purposes argentina name código único de identificación tributaria merchant registration id type cuit length 11 digits format xx xxxxxxxx x the first two digits represent the document type (e g , 30 for legal entities) the next eight digits identify the specific taxpayer the last digit is a check digit for verification description the cuit is a universal tax identification code assigned to all taxpayers in argentina, including companies mexico name registro federal de contribuyentes merchant registration id type rfc length 13 characters format x xxxxxxx x x the first character identifies the taxpayer type (e g , legal entity starts with a letter, individual starts with a number) the next four characters represent the serial number assigned to the taxpayer the fifth character is a verification code (homoclave) the last two characters represent the entity and year of registration description the rfc is the federal tax identification code used in mexico for companies and individuals chargeback reason codes card network chargeback type chargeback reason code chargeback reason description visa fraud 10 1 emv liability shift counterfeit fraud visa fraud 10 2 emv liability shift non counterfeit fraud visa fraud 10 3 other fraud — card present environment visa fraud 10 4 other fraud — card absent environment visa fraud 10 5 visa fraud monitoring program visa authorization 11 1 card recovery bulletin visa authorization 11 2 declined authorization visa authorization 11 3 no authorization visa processing errors 12 1 late presentment visa processing errors 12 2 incorrect transaction code visa processing errors 12 3 incorrect currency visa processing errors 12 4 incorrect account number visa processing errors 12 5 incorrect amount visa processing errors 12 6 1 duplicate processing visa processing errors 12 6 2 paid by other means visa processing errors 12 7 invalid data visa consumer disputes 13 1 merchandise/services not received visa consumer disputes 13 2 cancelled recurring visa consumer disputes 13 3 not as described or defective merchandise/services visa consumer disputes 13 4 counterfeit merchandise visa consumer disputes 13 5 misrepresentation visa consumer disputes 13 6 credit not processed visa consumer disputes 13 7 cancelled merchandise/services visa consumer disputes 13 8 original credit transaction not accepted visa consumer disputes 13 9 non receipt of cash or load transaction value mastercard authorization 4808 warning bulletin file mastercard authorization 4808 authorization related chargeback mastercard authorization 4808 account number not on file mastercard authorization 4808 required authorization not obtained mastercard authorization 4808 expired chargeback protection period mastercard authorization 4808 multiple authorization requests mastercard authorization 4808 cardholder activated terminal (cat) 3 device mastercard processing errors 4834 point of interaction error mastercard processing errors 4834 transaction amount differs mastercard processing errors 4834 late presentment mastercard processing errors 4834 point of interaction currency conversion mastercard processing errors 4834 duplication/paid by other means mastercard processing errors 4834 atm disputes mastercard processing errors 4834 loss, theft, or damages mastercard fraud 4837 no cardholder authorization mastercard fraud 4849 questionable merchant activity mastercard fraud 4870 emv chip liability shift mastercard fraud 4871 emv chip/pin liability shift mastercard consumer disputes 4853 cardholder dispute of a recurring transaction mastercard consumer disputes 4853 goods or services not provided mastercard consumer disputes 4853 no show hotel charge mastercard consumer disputes 4853 addendum dispute mastercard consumer disputes 4853 credit not processed mastercard consumer disputes 4853 goods/services not as described or defective mastercard consumer disputes 4853 digital goods $25 or less mastercard consumer disputes 4853 counterfeit goods mastercard consumer disputes 4853 transaction did not complete mastercard consumer disputes 4853 credit posted as a purchase mastercard consumer disputes 4854 cardholder dispute not classified elsewhere mastercard other 4850 instalment billing dispute (participating countries only) mastercard other 4999 domestic chargeback dispute (europe region only) american express authorization a01 charge amount exceeds authorization amount american express authorization a02 no valid authorization american express authorization a08 authorization approval expired american express fraud f10 missing imprint american express fraud f14 missing signature american express fraud f24 no card member authorization american express fraud f29 card not present american express fraud f30 emv counterfeit american express fraud f31 emv lost/stolen/non received american express fraud fr2 fraud full recourse program american express fraud fr4 immediate chargeback program american express fraud fr6 partial immediate chargeback program american express consumer disputes c02 credit not processed american express consumer disputes c04 goods/services returned or refused american express consumer disputes c05 goods/services cancelled american express consumer disputes c08 goods/services not received american express consumer disputes c14 paid by other means american express consumer disputes c18 “no show” or cardeposit cancelled american express consumer disputes c28 cancelled recurring billing american express consumer disputes c31 goods/services not as described american express consumer disputes c32 goods/services damaged or defective american express processing errors p01 unassigned card number american express processing errors p03 credit processed as charge american express processing errors p04 charge processed as credit american express processing errors p05 incorrect charge amount american express processing errors p07 late submission american express processing errors p08 duplicate charge american express processing errors p22 non matching card number american express processing errors p23 currency discrepancy american express other r03 insufficient reply american express other r13 no reply american express other m01 chargeback authorization american express other m10 vehicle rental capital damages american express other m49 vehicle rental theft or loss of use discover fraud ua01 fraud – card present transaction discover fraud ua02 fraud – card not present transaction discover fraud ua05 fraud – chip counterfeit transaction discover fraud ua06 fraud – chip and pin transaction discover fraud ua10 request transaction receipt (swiped card transactions) discover fraud ua11 cardholder claims fraud (swiped transaction, no signature) discover authorization na no authorization discover authorization da declined authorization discover authorization at authorization non compliance discover authorization ex expired card discover processing errors in invalid card number discover processing errors lp late presentation discover consumer disputes 5 good faith investigation discover consumer disputes aa does not recognise discover consumer disputes ap recurring payments discover consumer disputes aw altered amount discover consumer disputes cd credit/debit posted incorrectly discover consumer disputes dp duplicate processing discover consumer disputes ic illegible sales data discover consumer disputes nf non receipt of cash from atm discover consumer disputes pm paid by other means discover consumer disputes rg non receipt of goods, services, or cash discover consumer disputes rm cardholder disputes quality of goods or services discover consumer disputes rn2 credit not processed discover other dc dispute compliance discover other nc not classified merchant category codes below is a list of merchant category codes and the associated descriptions this is not a definitive list and should be viewed as a reference document rather than a source of origin on merchant category codes merchant category code (mcc) mcc description 7623 a/c, refrigeration repair 8931 accounting/bookkeeping services 7311 advertising services 763 agricultural cooperative 4511 airlines, air carriers 4582 airports, flying fields 4119 ambulance services 7996 amusement parks/carnivals 5937 antique reproductions 5932 antique shops 7998 aquariums 8911 architectural/surveying services 5971 art dealers and galleries 5970 artists supply and craft shops 7531 auto body repair shops 7535 auto paint shops 7538 auto service shops 5531 auto and home supply stores 6011 automated cash disburse 5542 automated fuel dispensers 8675 automobile associations 5533 automotive parts and accessories stores 5532 automotive tire stores 9223 bail and bond payments (payment to the surety for the bond, not the actual bond paid to the government agency) 5462 bakeries 7929 bands, orchestras 7230 barber and beauty shops 7995 betting/casino gambling 5940 bicycle shops 7932 billiard/pool establishments 5551 boat dealers 4457 boat rentals and leases 5942 book stores 5192 books, periodicals, and newspapers 7933 bowling alleys 4131 bus lines 8244 business/secretarial schools 7278 buying/shopping services 4899 cable, satellite, and other pay television and radio 5946 camera and photographic supply stores 5441 candy, nut, and confectionery stores 7512 car rental agencies 7542 car washes 5511 car and truck dealers (new & used) sales, service, repairs parts and leasing 5521 car and truck dealers (used only) sales, service, repairs parts and leasing 1750 carpentry services 7217 carpet/upholstery cleaning 5811 caterers 8398 charitable and social service organizations fundraising 5169 chemicals and allied products (not elsewhere classified) 8351 child care services 5641 childrens and infants wear stores 8049 chiropodists, podiatrists 8041 chiropractors 5993 cigar stores and stands 8641 civic, social, fraternal associations 7349 cleaning and maintenance 7296 clothing rental 8220 colleges, universities 5046 commercial equipment (not elsewhere classified) 5139 commercial footwear 7333 commercial photography, art and graphics 4111 commuter transport, ferries 4816 computer network services 7372 computer programming 7379 computer repair 5734 computer software stores 5045 computers, peripherals, and software 1771 concrete work services 5039 construction materials (not elsewhere classified) 7392 consulting, public relations 8241 correspondence schools 5977 cosmetic stores 7277 counseling services 7997 country clubs 4215 courier services 9211 court costs, including alimony and child support courts of law 7321 credit reporting agencies 4411 cruise lines 5451 dairy products stores 7911 dance hall, studios, schools 7273 dating/escort services 8021 dentists, orthodontists 5311 department stores 7393 detective agencies 5815 digital goods media – books, movies, music 5817 digital goods – applications (excludes games) 5816 digital goods – games 5818 digital goods – large digital goods merchant 5964 direct marketing catalog merchant 5965 direct marketing combination catalog and retail merchant 5967 direct marketing inbound telemarketing 5960 direct marketing insurance services 5969 direct marketing other 5966 direct marketing outbound telemarketing 5968 direct marketing subscription 5962 direct marketing travel 5310 discount stores 8011 doctors 5963 door to door sales 5714 drapery, window covering, and upholstery stores 5813 drinking places 5912 drug stores and pharmacies 5122 drugs, drug proprietaries, and druggist sundries 7216 dry cleaners 5099 durable goods (not elsewhere classified) 5309 duty free stores 5812 eating places, restaurants 8299 educational services 5997 electric razor stores 5552 electric vehicle charging 5065 electrical parts and equipment 1731 electrical services 7622 electronics repair shops 5732 electronics stores 8211 elementary, secondary schools 9702 emergency services (gcas) (visa use only) 7361 employment/temp agencies 7394 equipment rental 7342 exterminating services 5651 family clothing stores 5814 fast food restaurants 6012 financial institutions 9222 fines government administrative entities 5718 fireplace, fireplace screens, and accessories stores 5713 floor covering stores 5992 florists 5193 florists supplies, nursery stock, and flowers 5422 freezer and locker meat provisioners 5983 fuel dealers (non automotive) 7261 funeral services, crematories 7641 furniture repair, refinishing 5712 furniture, home furnishings, and equipment stores, except appliances 5681 furriers and fur shops 1520 general services 5947 gift, card, novelty, and souvenir shops 5231 glass, paint, and wallpaper stores 5950 glassware, crystal stores 7992 golf courses public 7801 government licensed on line casinos (on line gambling)(us region only) 9399 government services (not elsewhere classified) 7802 government licensed horse/dog racing (us region only) 9406 government owned lotteries (non us region) 7800 government owned lotteries (us region only) 5411 grocery stores, supermarkets 5251 hardware stores 5072 hardware, equipment, and supplies 7298 health and beauty spas 5975 hearing aids sales and supplies 1711 heating, plumbing, a/c 5945 hobby, toy, and game shops 5200 home supply warehouse stores 8062 hospitals 7011 hotels, motels, and resorts 5722 household appliance stores 5085 industrial supplies (not elsewhere classified) 7375 information retrieval services 6399 insurance default 6300 insurance underwriting, premiums 9950 intra company purchases 5944 jewelry stores, watches, clocks, and silverware stores 780 landscaping services 7211 laundries 7210 laundry, cleaning services 8111 legal services, attorneys 5948 luggage and leather goods stores 5211 lumber, building materials stores 6010 manual cash disburse 4468 marinas, service and supplies 5262 marketplaces 1740 masonry, stonework, and plaster 7297 massage parlors 8099 medical services 8071 medical and dental labs 5047 medical, dental, ophthalmic, and hospital equipment and supplies 8699 membership organizations 5611 mens and boys clothing and accessories stores 5691 mens, womens clothing stores 5051 metal service centers 5699 miscellaneous apparel and accessory shops 5599 miscellaneous auto dealers 7399 miscellaneous business services 5499 miscellaneous food stores convenience stores and specialty markets 5399 miscellaneous general merchandise 7299 miscellaneous general services 5719 miscellaneous home furnishing specialty stores 2741 miscellaneous publishing and printing 7999 miscellaneous recreation services 7699 miscellaneous repair shops 5999 miscellaneous specialty retail 5271 mobile home dealers 7832 motion picture theaters 4214 motor freight carriers and trucking local and long distance, moving and storage companies, and local delivery services 5592 motor homes dealers 5013 motor vehicle supplies and new parts 5571 motorcycle shops and dealers 5561 motorcycle shops, dealers 5733 music stores musical instruments, pianos, and sheet music 5994 news dealers and newsstands 6051 non fi, money orders 6540 non fi, stored value card purchase/load 5199 nondurable goods (not elsewhere classified) 5261 nurseries, lawn and garden supply stores 8050 nursing/personal care 5021 office and commercial furniture 8043 opticians, eyeglasses 8042 optometrists, ophthalmologist 5976 orthopedic goods prosthetic devices 8031 osteopaths 5921 package stores beer, wine, and liquor 5198 paints, varnishes, and supplies 7523 parking lots, garages 4112 passenger railways 5933 pawn shops 5995 pet shops, pet food, and supplies 5172 petroleum and petroleum products 7395 photo developing 7221 photographic studios 5044 photographic, photocopy, microfilm equipment, and supplies 7829 picture/video production 5131 piece goods, notions, and other dry goods 5074 plumbing, heating equipment, and supplies 8651 political organizations 9402 postal services government only 5094 precious stones and metals, watches and jewelry 8999 professional services 4225 public warehousing and storage farm products, refrigerated goods, household goods, and storage 7338 quick copy, repro, and blueprint 4011 railroads 6513 real estate agents and managers rentals 5735 record stores 7519 recreational vehicle rentals 5973 religious goods stores 8661 religious organizations 1761 roofing/siding, sheet metal 7339 secretarial support services 6211 security brokers/dealers 5541 service stations 5949 sewing, needlework, fabric, and piece goods stores 7251 shoe repair/hat cleaning 5661 shoe stores 7629 small appliance repair 5598 snowmobile dealers 1799 special trade services 2842 specialty cleaning 5941 sporting goods stores 7032 sporting/recreation camps 7941 sports clubs/fields 5655 sports and riding apparel stores 5972 stamp and coin stores 5111 stationary, office supplies, printing and writing paper 5943 stationery stores, office, and school supply stores 5996 swimming pools sales 4723 tui travel germany 5697 tailors, alterations 9311 tax payments government agencies 7276 tax preparation services 4121 taxicabs/limousines 4812 telecommunication equipment and telephone sales 4814 telecommunication services 4821 telegraph services 5998 tent and awning shops 8734 testing laboratories 7922 theatrical ticket agencies 7012 timeshares 7534 tire retreading and repair 4784 tolls/bridge fees 7991 tourist attractions and exhibits 7549 towing services 7033 trailer parks, campgrounds 4789 transportation services (not elsewhere classified) 4722 travel agencies, tour operators 7511 truck stopiteration 7513 truck/utility trailer rentals 2791 typesetting, plate making, and related services 5978 typewriter stores 9405 u s federal government agencies or departments 5137 uniforms, commercial clothing 5931 used merchandise and secondhand stores 4900 utilities 5331 variety stores 742 veterinary services 7993 video amusement game supplies 7994 video game arcades 7841 video tape rental stores 8249 vocational/trade schools 7631 watch/jewelry repair 7692 welding repair 5300 wholesale clubs 5698 wig and toupee stores 4829 wires, money orders 5631 women's accessory and specialty shops 5621 women's ready to wear stores 5935 wrecking and salvage yards