Creating payment assets using an XML file

To create payment assets for your store using an XML file when WebSphere Commerce Payments is used:

  1. Review the XML files used to create payment assets for the starter stores. All files for the starter stores are located in the corresponding store archive file.

    The store archive files are located in the following directory:

    Each starter store includes a paymentinfo.xml file, which include the payment information. To view the paymentinfo.xml file in the store archive, decompress it using a ZIP program. The paymentinfo.xml files are located in the data directory. Payment asset files are used primarily for the CustomOffline and Offline Card cassettes.

  2. Create a paymentinfo.xml file, either by copying one of the paymentinfo.xml files in the starter store archives, or by creating a new one. For more information, see the DTD file that corresponds to the paymentinfo.xml. The DTD file is located in the following directory: WC_installdir/xml/sar.

    Advanced orders A payment asset file is required for standard order processing, as well as for advanced order processing if you are planning to use WebSphere Commerce Payments with any of your stores.

  3. Enable or disable WebSphere Commerce Payments.
    1. Using the following example as your guide, in your XML file enable or disable WebSphere Commerce Payments and specify what types of payment cassette, currencies and brands your store accepts:
      <paymentinfo>
        <PaymentManager enable="yes"/> 
        <Cassette type="OfflineCard"> 
         <Account currency="USD">
          <Brand type="MasterCard"/>
          <Brand type="VISA"/>
          <Brand type="American Express"/>
         <Account/>
         <Account currency="EUR">
          <Brand type="MasterCard"/>
          <Brand type="VISA"/>
          <Brand type="American Express"/>
         </Account>
        </Cassette>
      </paymentinfo>   
      

      where:

      • enable is whether WebSphere Commerce Payments is enabled or disabled. When WebSphere Commerce Payments is disabled, your store will not be able to process payment transactions through the Payments component, although the Payments user interface will still function. If you disable the Payments component, there is no need to specify the other elements in the paymentinfo element.
      • Cassette type is the type of cassette supported.
      • Account currency is the currency your store supports. Account currency is required if you are using the OfflineCard cassette type. The currency must be identified in a three-letter code conforming to the ISO 4217 standard. For example, "USD" for U.S. dollars.
      • Brand type is the type of credit card supported by the account and the currency.

Feedback