Purchasing cards

Purchasing Cards offer businesses the ability to allow their employees to purchase items with a credit card while providing additional information on sales tax, customer code etc. When providing specific details on the payment being made with a Purchasing card favourable addendum interchange rates are applied.

There are 3 levels of details required for Purchasing Cards:

Level I (L1) — standard transaction data; no enhanced data is required at this level.
Level II (L2) — requires that data such as tax amount and customer code be supplied in addition to the standard transaction date. (i.e. Visa only has a level II option)
Level III (L3) — allows a merchant to pass a detailed accounting of goods and services purchased to the buyer. All the data for Level I and Level II must also be passed to participate in Level III. (i.e. for both Visa and Mastercard).

A PurchaseCard element can contain contain 0-100 LineItemData elements.

The following represents an example of a purchasing card L3 transaction including a single LineItemData element and mandatory fields. As well as an example with multiple LineItemData elements with all possible fields populated:

<?xml version="1.0" encoding="UTF-8"?><SOAP-ENV:Envelope xmlns:SOAPENV="http://schemas.xmlsoap.org/soap/envelope/">
 <SOAP-ENV:Header/>
 <SOAP-ENV:Body>
 <ns4:IPGApiOrderRequest 
xmlns:ns4="http://ipg-online.com/ipgapi/schemas/ipgapi" 
xmlns:ns2="http://ipg-online.com/ipgapi/schemas/a1" 
xmlns:ns3="http://ipg-online.com/ipgapi/schemas/v1">
 <ns3:Transaction>
     <ns3:CreditCardTxType>
         <ns3:StoreId>110995100</ns3:StoreId>
         <ns3:Type>sale</ns3:Type>
     </ns3:CreditCardTxType>
     <ns3:CreditCardData>
         <ns3:CardNumber>4035*****4977</ns3:CardNumber>
         <ns3:ExpMonth>12</ns3:ExpMonth>
         <ns3:ExpYear>28</ns3:ExpYear>
         <ns3:CardCodeValue>XXX</ns3:CardCodeValue>
     </ns3:CreditCardData>
     <ns3:Payment>
         <ns3:ChargeTotal>23</ns3:ChargeTotal>
         <ns3:Currency>GBP</ns3:Currency>
     </ns3:Payment>
     <ns3:TransactionDetails>
       <ns3:PurchaseCard>
         <ns3:CustomerReferenceID>9632587410</ns3:CustomerReferenceID>
         <ns3:SupplierInvoiceNumber>321456987</ns3:SupplierInvoiceNumber>
         <ns3:SupplierVATRegistrationNumber>GB18150620</ns3:SupplierVATRegistrationNumber>
       <ns3:LineItemData>
         <ns3:CommodityCode>0</ns3:CommodityCode>
         <ns3:Description>DIRECT MARKETING PURCH</ns3:Description>
         <ns3:Quantity>200000</ns3:Quantity>
         <ns3:UnitOfMeasure>TPR</ns3:UnitOfMeasure>
         <ns3:UnitPrice>1200</ns3:UnitPrice>
         <ns3:LineItemTotal>1200</ns3:LineItemTotal>
       </ns3:LineItemData>
         </ns3:PurchaseCard>
       </ns3:TransactionDetails>
     </ns3:Transaction>
   </ns4:IPGApiOrderRequest>
 </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
<?xml version="1.0" encoding="UTF-8"?><SOAP-ENV:Envelope 
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
 <SOAP-ENV:Header/>
 <SOAP-ENV:Body>
   <ns3:IPGApiOrderRequest 
xmlns:ns3="http://ipg-online.com/ipgapi/schemas/ipgapi" 
xmlns:ns2="http://ipg-online.com/ipgapi/schemas/v1" 
xmlns:ns4="http://ipg-online.com/ipgapi/schemas/a1">
    <ns2:Transaction>
        <ns2:CreditCardTxType>
            <ns2:StoreId>110995100</ns2:StoreId>
            <ns2:Type>preAuth</ns2:Type>
     </ns2:CreditCardTxType>
     <ns2:CreditCardData>
         <ns2:CardNumber>4035*****4977</ns2:CardNumber>
         <ns2:ExpMonth>12</ns2:ExpMonth>
         <ns2:ExpYear>28</ns2:ExpYear>
         <ns2:CardCodeValue>XXX</ns2:CardCodeValue>
     </ns2:CreditCardData>
     <ns2:Payment>
         <ns2:SubTotal>15</ns2:SubTotal>
         <ns2:ValueAddedTax>4</ns2:ValueAddedTax>
         <ns2:DeliveryAmount>5</ns2:DeliveryAmount>
         <ns2:ChargeTotal>24</ns2:ChargeTotal>
         <ns2:Currency>GBP</ns2:Currency>
     </ns2:Payment>
     <ns2:TransactionDetails>
         <ns2:PurchaseCard> 
<ns2:CustomerReferenceID>9632587410</ns2:CustomerReferenceID> 
<ns2:SupplierInvoiceNumber>321456987</ns2:SupplierInvoiceNumber> 
<ns2:SupplierVATRegistrationNumber>GB1820</ns2:SupplierVATRegistrationNumber>
            <ns2:TotalDiscountAmountAndRate>
                <ns2:Amount>55</ns2:Amount>
                <ns2:Rate>99.99</ns2:Rate>
            </ns2:TotalDiscountAmountAndRate>
            <ns2:VATShippingAmountAndRate>
                <ns2:Amount>35</ns2:Amount>
                <ns2:Rate>0.10</ns2:Rate>
            </ns2:VATShippingAmountAndRate>
                <ns2:LineItemData> 
                <ns2:CommodityCode>1112</ns2:CommodityCode>
                <ns2:ProductCode>22369852147</ns2:ProductCode> 
                <ns2:Description>DIRECTMARKETINGPURCH</ns2:Description>
                <ns2:Quantity>200000</ns2:Quantity>
                <ns2:UnitOfMeasure>TPR</ns2:UnitOfMeasure>
                <ns2:UnitPrice>1200</ns2:UnitPrice>
                    <ns2:VATAmountAndRate>
                        <ns2:Amount>9999</ns2:Amount>
                        <ns2:Rate>0.1</ns2:Rate>
                    </ns2:VATAmountAndRate>
                    <ns2:DiscountAmountAndRate>
                        <ns2:Amount>13</ns2:Amount>
                        <ns2:Rate>99.99</ns2:Rate>
                    </ns2:DiscountAmountAndRate>
                    <ns2:LineItemTotal>1200</ns2:LineItemTotal>
                  </ns2:LineItemData>
                  <ns2:LineItemData>
                      <ns2:CommodityCode>5647</ns2:CommodityCode>
                      <ns2:ProductCode>22369852148</ns2:ProductCode>
                      <ns2:Description>DIRECTMARKETINGPURCH</ns2:Description>
                      <ns2:Quantity>200001</ns2:Quantity>
                      <ns2:UnitOfMeasure>DAY</ns2:UnitOfMeasure>
                      <ns2:UnitPrice>1201</ns2:UnitPrice>
                      <ns2:VATAmountAndRate>
                          <ns2:Amount>9999</ns2:Amount>
                          <ns2:Rate>0.2</ns2:Rate>
                      </ns2:VATAmountAndRate>
                      <ns2:DiscountAmountAndRate>
                          <ns2:Amount>14</ns2:Amount>
                          <ns2:Rate>99.99</ns2:Rate>
                      </ns2:DiscountAmountAndRate>
                      <ns2:LineItemTotal>1202</ns2:LineItemTotal>
                  </ns2:LineItemData>
                  <ns2:LineItemData>
                      <ns2:CommodityCode>575</ns2:CommodityCode>
                      <ns2:ProductCode>22369852149</ns2:ProductCode>
                      <ns2:Description>DIRECTMARKETINGPURCH</ns2:Description>
                      <ns2:Quantity>200002</ns2:Quantity>
                      <ns2:UnitOfMeasure>ACR</ns2:UnitOfMeasure>
                      <ns2:UnitPrice>1203</ns2:UnitPrice>
                      <ns2:VATAmountAndRate>
                          <ns2:Amount>9999</ns2:Amount>
                          <ns2:Rate>0.3</ns2:Rate>
                      </ns2:VATAmountAndRate>
                      <ns2:DiscountAmountAndRate>
                          <ns2:Amount>15</ns2:Amount>
                          <ns2:Rate>99.99</ns2:Rate>
                      </ns2:DiscountAmountAndRate>
                      <ns2:LineItemTotal>1204</ns2:LineItemTotal>
                  </ns2:LineItemData>
              </ns2:PurchaseCard>
            </ns2:TransactionDetails>
          </ns2:Transaction>
        </ns3:IPGApiOrderRequest>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

If a LineItemData element was removed, the example above would represent a purchasing card L2 transaction.


Want a quick overview?