Skip to main content

Basket Details

TransactDirect supports flexible basket details through the Payments API and Checkout Page.

The Basket should be construted using the JSON format described in this article and then Base64 encoded and sent along with the payment request in the Basket field.

For Large Ticket Interchange applicable baskets the LTI column indicates all fields that should be considered mandatory. See also Large Ticket Interchange

Basket Format​

The Basket JSON object is made up of the following elements

Field NameDescriptionReq'dLTI
taxTypeIndicates the tax type for all amounts in this basket. See Tax Types. Defaults to Inclusive if not set.OM
itemsA list of all items in the basket. See Item Object.MM
discountsA list of any discounts applied to the basket. See Discount Object.OO
taxesA list of transaction level tax summaries applied to the basket. See Tax Object.OProhibited
deliveryDelivery details for this basket. See Delivery Object.OO
invoiceAdditional information related to the invoice for this basket. See InvoiceOM

Tax Types​

Tax TypeDescription
InclusiveAll line item, discount, and delivery amounts must be supplied inclusive of all taxes.
Additional tax details are recommended but not required.
ExclusiveAll line item, discount, and delivery amounts must be supplied exclusive of any taxes.
Tax code, tax rate, and tax amount are required.
ExemptOrder is tax exempt. No additional tax details are expected for this basket.

Notes​

  • When not specified taxType defaults to Inclusive.
  • For Large Ticket Interchange applicable baskets the taxType must be either Exclusive or Exempt.
  • Taxes can be supplied at either:
    • Line level on each individual item, discount, and delivery.
    • Transaction level tax totals in the taxes collection.
warning

Tax details must only be supplied once, at either line level OR summarised at transaction level.

For LTI applicable baskets tax details must be supplied at line level.

Item Object​

Field NameDescriptionReq'dTypeLTI
descriptionThe product description for this item.MAM
quantityThe quantity of this item on this order line.MNM
unitPriceThe unit price for this product in major currency. e.g. 3.99MNM
unitOfMeasureThe unit of measure for this product. e.g. litres, metres.OAM
totalThe total price for this order line. If not supplied it will be calculated automatically.ON
taxCodeThe tax code applied to this line.C*A
taxRateThe tax rate applied to this line. e.g 20 (VAT)C*NM
taxAmountThe tax amount applied to this line.C*NM
skuThe stock code for this product.OA
commodityCodeThe 4-digit standard commodity code for this product. See Commodity CodesO*A4M
discountAmountThe discount amount applied to this order line.ONO

Notes​

  • The unitPrice can be quoted to 4 decimal places if required.
  • When taxType is set to Inclusive all items must be supplied with their unitPrice and total inclusive of all taxes.
  • When taxType is set to Exclusive all items must be supplied with their unitPrice and total exclusive of any taxes.
  • When tax details are included for a line item taxRate and taxAmount become mandatory, taxCode is recommended.
  • commodityCode is typically only required for advanced basket integrations. e.g. LTI.

Discount Object​

Field NameDescriptionReq'dTypeLTI
codeThe discount code.OA
descriptionThe description for this discount.MA
rateThe rate of discount applied. e.g. 5.0ON
amountThe amount of discount in major currency. e.g. 1.99MNM
taxCodeThe tax code applied to this discount.C*A
taxRateThe tax rate applied to this discount. e.g 20 (VAT)C*N
taxAmountThe tax amount applied to this discount.C*N

Notes​

  • When taxType is set to Inclusive discounts must be supplied with their amount inclusive of all taxes.
  • When taxType is set to Exclusive discounts must be supplied with their amount exclusive of any taxes.
  • When tax details are included for a line item taxRate and taxAmount become mandatory, taxCode is recommended.

Tax Object​

Field NameDescriptionReq'dType
codeThe tax code.MA
descriptionDescription of this tax item.OA
rateThe rate at which this tax item is applied. e.g. 20 (VAT)MN
amountThe amount of tax applied in major currency. e.g. 2.50MN

Notes​

  • When taxType is set to Inclusive all basket amounts must be supplied inclusive of the tax items specified here.
  • When taxType is set to Exclusive all basket amounts must be supplied exclusive of the tax items specified here.
  • If taxes are supplied at transaction level in the taxes collection the taxCode, taxRate, and taxAmount fields should not be populated on individual items.
  • Summary tax is prohibited for LTI transactions. Taxes must be supplied at line item level.

Delivery Object​

Field NameDescriptionReq'dTypeLTI
carrierThe carrier used for delivery.MA
amountThe cost for this delivery in major currency. e.g. 2.50MNO
taxCodeThe tax code applied to this delivery cost.C*A
taxRateThe tax rate applied to this delivery cost. e.g. 20 (VAT)C*NO
taxAmountThe tax amount applied to this delivery cost.C*NO

Notes​

  • When taxType is set to Inclusive delivery details must be supplied with the amount inclusive of all taxes.
  • When taxType is set to Exclusive delivery details must be supplied with the amount exclusive of any taxes.
  • When tax details are included for a line item taxRate and taxAmount become mandatory, taxCode is recommended.
  • Delivery details are optional for LTI transactions and have no additional requirement is supplied.

Invoice Object​

Field NameDescriptionReq'dTypeLTI
invoiceNumberThe invoice number.OAM*1
orderNumberThe order number.OAM*1
addresseeThe addressee name.OA
customerTaxNumberThe addressee's tax registration number.OAM*2
isTaxExemptIndicates if this invoice is for a tax exempt organisation (e.g. Government.). true or false (default)OB
dueDateThe due date of this invoice.OISO 8601
issueDateThe issue date of this invoice.OISO 8601
orderDateThe order date for this basket of goods.OISO 8601M
cardAcceptorTaxNumberThe tax registration number of the merchant.

Notes​

  • For LTI either an invoiceNumber or orderNumber is required.
  • For LTI cross border transactions the customerTaxNumber is required, otherwise optional.

Request Samples​

This example shows a simple basket with all tax inclusive amounts but no specific tax details

Basket total value £13.99

JSON​

{
  "taxType": "inclusive",
  "items": [
    {
      "sku": "AP001",
      "commodityCode": "3200",
      "description": "White Matt Paint",
      "quantity": 1,
      "unitPrice": 12.99,
      "unitOfMeasure": "5 litre pot",
      "total": 12.99
    }
  ],
  "discounts": [
    {
      "code": "PAINT",
      "description": "Paint Promo",
      "amount": 0.99
    }
  ],
  "delivery": {
    "carrier": "Royal Mail Tracked 48\u2122",
    "amount": 1.99
  },
  "invoice": {
    "invoiceNumber": "JONES123123",
    "orderNumber": "MSPS2138",
    "addressee": "Mr Smith's Paint Shop",
    "customerTaxNumber": "GB12345678",
    "isTaxExempt": false,
    "dueDate": "2025-04-01T12:00:00",
    "issueDate": "2025-03-01T12:00:00",
    "orderDate": "2025-03-01T12:00:00"
  }
}

Base64​

eyJ0YXhUeXBlIjoiaW5jbHVzaXZlIiwiaXRlbXMiOlt7InNrdSI6IkFQMDAxIiwiY29tbW9kaXR5Q29k
ZSI6IjMyMDAiLCJkZXNjcmlwdGlvbiI6IldoaXRlIE1hdHQgUGFpbnQiLCJxdWFudGl0eSI6MSwidW5p
dFByaWNlIjoxMi45OSwidW5pdE9mTWVhc3VyZSI6IjUgbGl0cmUgcG90IiwidG90YWwiOjEyLjk5fV0s
ImRpc2NvdW50cyI6W3siY29kZSI6IlBBSU5UIiwiZGVzY3JpcHRpb24iOiJQYWludCBQcm9tbyIsImFt
b3VudCI6MC45OX1dLCJkZWxpdmVyeSI6eyJjYXJyaWVyIjoiUm95YWwgTWFpbCBUcmFja2VkIDQ4PyIs
ImFtb3VudCI6MS45OX0sImludm9pY2UiOnsiaW52b2ljZU51bWJlciI6IkpPTkVTMTIzMTIzIiwib3Jk
ZXJOdW1iZXIiOiJNU1BTMjEzOCIsImFkZHJlc3NlZSI6Ik1yIFNtaXRoJ3MgUGFpbnQgU2hvcCIsImN1
c3RvbWVyVGF4TnVtYmVyIjoiR0IxMjM0NTY3OCIsImlzVGF4RXhlbXB0IjpmYWxzZSwiZHVlRGF0ZSI6
IjIwMjUtMDQtMDFUMTI6MDA6MDAiLCJpc3N1ZURhdGUiOiIyMDI1LTAzLTAxVDEyOjAwOjAwIiwib3Jk
ZXJEYXRlIjoiMjAyNS0wMy0wMVQxMjowMDowMCJ9fQ==

Large Ticket Interchange​

Where a merchant agreement with Monek includes provision for Large Ticket Intercharge, or LTI, rates the merchant will need to provide additional transaction details.

The LTI column on the Basket specifications indicate data that is mandatory for LTI applicable transactions.

LTI Implementation Notes​

  • LTI baskets must quote all amounts exclusive of Tax using a basket taxType of either Exclusive or Exempt.
  • LTI baskets must use only line item taxes.
  • If LTI baskets use summary discount items:
    • Where line item unit costs are quoted post discount then discount amounts = zero.
    • Where line item unit costs are quotes pre discount then discount amounts should be reported.
  • Line items must include a valid commodity code from the Commodity Codes table.

Character Encoding​

To ensure correct display on the Checkout Page, JSON requires that some characters are encoded. Including, but not limited to, those below.

CharacterDescriptionEncoding
£Pound symbol\u00A3
™Trademark symbol\u2122

Commodity Codes​

Standard commodity codes. Typically only required for advanced Basket integrations.

CodeDescriptionNotes
0000UNSPECIFIED - ONLY USED WITH PRIOR AGREEMENT
0100LIVE ANIMALS
0200MEAT/MEAT PRODUCTS
0300FISH/SEAFOOD PRODUCTS
0400DAIRY PRODUCE
0600PLANTS, SHRUBS AND TREES
0700VEGETABLES AND VEGETABLE PRODUCTS
0800FRUIT AND FRUIT PRODUCTS
0900BEVERAGES - NON-ALCOHOLIC
1200ANIMAL FEEDING STUFFS
2200ALCOHOLIC BEVERAGES
2260PUBLISHING SERVICES
2261PRINTING SERVICES
2400TOBACCO/TOBACCO PRODUCTS
2500BUILDING AGGREGATES
2700SOLID FUEL; HEATING/ INDUSTRIAL/ AGRICULTURAL OILS
2701PETROL/DIESEL - ROAD FUELUK Only
2702LUBRICATING OILS
2703DIESEL/PETROL – ROAD FUELROI Only
2800CHEMICALS/ACIDS
3000FIRST AID PRODUCTS
3100AGRICULTURAL FERTILISERS
3200PAINTS/VARNISHES
3400CLEANING PRODUCTS
3600INDUSTRIAL EXPLOSIVES
3700PHOTOGRAPHIC FILM PRODUCTS
3760WASTE DISPOSAL SERVICES
3800INSECTICIDES/FUNGICIDES/DISINFECTANTS
4000RUBBER PRODUCTS
4001TYRES - MOTOR VEHICLES
4200LEATHER CASES AND BAGS
4560CONSTRUCTION/DEMOLITION SERVICES
4561ROOFING SERVICES
4562ELECTRICAL CONTRACTING
4563PLUMBING, HEATING AND DRAINAGE SERVICES
4564PLASTERING SERVICES
4565JOINERY SERVICES
4566PAINTING/GLAZING SERVICES
4700WOOD, TIMBER PRODUCTS, PULP AND PAPER PRODUCTS
4800OFFICE STATIONERY
4801NEWSPRINT
4802WALLPAPER
4900BOOKS: PRINTED MATERIAL
5060MOTOR VEHICLE REPAIR/MAINTENANCE SERVICES
5560HOTEL/RESTAURANT SERVICES
5561CATERING SERVICES
5600ROPE, CABLE, NETTING
5700CARPETS/FLOOR COVERINGS
6060PASSENGER TRANSPORT
6061FREIGHT TRANSPORT SERVICESVisa Only
6200CLOTHING
6300PACKING MATERIALS/SACKS/BAGS
6360STORAGE/WAREHOUSING SERVICES
6361TRAVEL AGENCY SERVICES
6362FREIGHT / CARRIAGE CHARGES (NON-COURIER / DELIVERY SERVICE PROVIDERS)Visa Only
6400FOOTWEAR
6460COURIER SERVICES (COURIER / DELIVERY SERVICES PROVIDERS)
6461TELECOMMUNICATIONS SERVICES
6500HEADGEAR
6560FINANCIAL SERVICES (NON-INSURANCE)
6561EQUIPMENT LEASING SERVICES
6562CAR LEASING SERVICES: QUALIFYING CARSUK Only
6563COMMERCIAL VEHICLE LEASING SERVICES
6564FACTORING SERVICES
6565CAR LEASING SERVICES: NON - QUALIFYING CARSUK Only
6600UMBRELLAS AND WALKING STICKS
6660INSURANCE SERVICES - GENERAL
6760FINANCIAL ADMINISTRATION SERVICES
6761PENSION ADVISORY/ADMINISTRATION SERVICES
6900BUILDING BRICKS/TILES/STONES
6901SINKS, BATHS, WASHBASINS; OTHER PLUMBING/HEATING PRODUCTS
7000GLASSWARE
7060PROPERTY RENTALS
7061ESTATE AGENCY SERVICES
7062PROPERTY MANAGEMENT SERVICES
7100INDUSTRIAL METALS (BASE/PROCESSED)
7160CAR HIRE SERVICES: QUALIFYING CARS
7161RENTAL OF AGRICULTURAL MACHINERY
7162RENTAL OF CONSTRUCTION EQUIPMENT
7163COMPUTER/OFFICE MACHINE RENTAL
7164RENTAL OF SPORTS/RECREATIONAL EQUIPMENT
7260COMPUTER CONSULTANCY SERVICES
7261DATA PROCESSING SERVICES
7262MAINTENANCE/REPAIR - OFFICE EQUIPMENT
7300BARBED WIRE/FENCING
7460LEGAL SERVICES - LAWYERS/SOLICITORS
7461ACCOUNTING/TAX CONSULTANCY SERVICES
7462MARKET RESEARCH SERVICES
7463MANAGEMENT CONSULTANCY SERVICES
7464ADVERTISING AND MARKETING SERVICES
7465TECHNICAL ANALYSIS SERVICES
7466EMPLOYMENT BUREAU SERVICES
7467SITE SECURITY SERVICES
7468CLEANING SERVICES
7469PHOTOGRAPHIC SERVICES
7470PACKING SERVICES
7471SECRETARIAL/TRANSLATION SERVICES
7472OTHER BUSINESS SERVICES
7560STATUTORY CHARGES/LICENSES
8060DRIVING TUITION SERVICES
8061EMPLOYEE TRAINING
8200HAND TOOLS
8201MACHINE TOOLS
8202MACHINE/HAND TOOL PARTS
8300PADLOCKS, LOCKS, KEYS. SAFES, STRONG BOXES, OTHER IRONMONGERY PRODUCTS
8400INDUSTRIAL MECHANICAL APPLIANCES/PARTS
8401INDUSTRIAL ENGINES/PLANT: PARTS
8402INDUSTRIAL PLANT/EQUIPMENT
8403KITCHEN EQUIPMENT
8404FIRE EXTINGUISHERS
8405COMPUTER HARDWARE
8406COMPUTER SOFTWARE
8407VENDING MACHINES
8500GENERATORS/ELECTRIC MOTORS
8501TELEPHONES
8502RECORD/CASSETTE/CD PLAYERS
8503TAPE RECORDERS/ANSWERING MACHINES
8504VIDEO RECORDERS
8505RADIOS
8506TELEVISION SETS
8507BURGLAR & FIRE ALARMS
8508ELECTRICAL SWITCHES/FUSES/PLUGS/CIRCUITS
8509ELECTRIC LAMPS
8560MEDICAL SERVICES
8600RAILWAY LOCOMOTIVE PARTS
8700MOTOR CARS
8701COMMERCIAL MOTOR VEHICLES
8702SPECIAL PURPOSE VEHICLES
8703MOTOR VEHICLE PARTS (EXCLUDING TYRES)
8704MOTORCYCLES/SIDECARS
8705BICYCLES/TRICYCLES
8706TRAILERS/TRAILER PARTS
8800AIRCRAFT PARTS
9000BINOCULARS/TELESCOPES
9001CAMERAS/FLASHES
9002PHOTOCOPIERS
9003MICROSCOPES
9004MEASURING EQUIPMENT
9100CLOCKS, WATCHES & PARTS
9160MEMBERSHIP SUBSCRIPTIONS
9200MUSICAL INSTRUMENTS
9260MEDIA/NEWS AGENCY SERVICES
9261LIBRARY/ARCHIVING SERVICES
9360EMPLOYEE WELFARE SERVICES
9400OFFICE FURNITURE
9500TOYS, GAMES AND MODELS
9999VAT: INSURANCE REPAIRS