Configuring Merchant/400 Objects for Use with Net.Commerce version 3.2


To enable the special Merchant/400 objects for use in a Net.Commerce version 3.2 store environment, you will need to configure the Net.Commerce application to register the customized API and macros so it can find and use them. To do this, you will need to modify various Net.Commerce database files to reflect the new names and references. As a result, some AS/400 database or SQL knowledge will be helpful for the completion of this task. Knowledge of the Net.Commerce browser-based configuration will also be helpful while activating the Net.Data macros. It is important to note that the Merchant/400 integration is accomplished via Process Task API Execution rather than Overridable Functions, since the functionality and configuration of each can be easily confused.

Special thanks to Martin Holmes of Morpheus, Ltd. (www.morpheus.ltd.uk) for his work on this page and the API registration technique that it employs.

Activating the Customized do_payment API in Net.Commerce version 3.2

Perform the following steps to activate the customized do_payment process task API functionality that will execute credit card transactions via Merchant/400 (please refer to the Net.Commerce documentation for additional information about the assignment of process task APIs and macros):

  1. Ensure that you are authorized to replace the DO_PAYMENT task.
  2. Register the Merchant/400 Payment API in Net.Commerce.
  3. APIRFNBR

    APIMERNBR

    APIDLLNAME

    APIFUNCNAME

    2015

    <merchant_id>

    WWWSERVER/

    WWWMNCMA

    NCApiDoPayment

    NOTE: The <merchant_id> reference is the MERFNBR value for your store in the MERCHANT file in your instance library.

     

  4. Override the DO_PAYMENT process with the Merchant/400 API.
  5. TASK_RN

    MERCHANT_RN

    OF_RN

    SEQUENCE

    2015

    <merchant_id>

    2215

    -

    NOTE: The OF_RN reference is the REFNUM value for the DoPaymentProxy function in the OFS table in your instance library.

     

Activating the Customized Net.Data macros in Net.Commerce

Special Net.Data macros are included to retrieve specialized data about the order and shopper, and to deliver Merchant/400 information to the shopper about the results of their credit card transaction. Once the macro files are moved into place, you should perform the following steps to activate the customized macro for do_payment errors:
  1. Ensure that you are authorized to replace the DO_PAYMENT error macro.
  2. Open the Net.Commerce Administrator using your browser.
  3. On the task bar, click Site Manager.
  4. Click Task Management to display the Task Management form.
  5. Select the API task type from the Select Task Type drop-down list. A list of tasks appears in the bottom frame.
  6. Select the DO_PAYMENT task name from the list. The fields automatically fill with task information.
  7. Go to the Macro Assignment form by clicking Task Assignment and then API Error Macro....
  8. Enter the following in the Macro Filename field on the Macro Assignment form:
  9. Click Save.
Perform the following steps to activate the customized macro for order acceptance:
  1. Ensure that you are authorized to replace the ORD_OK macro.
  2. Open the Net.Commerce Administrator using your browser.
  3. On the task bar, click Site Manager.
  4. Click Task Management to display the Task Management form.
  5. Select the ORDER task type from the Select Task Type drop-down list. A list of tasks appears in the bottom frame.
  6. Select the ORD_OK task name from the list. The fields automatically fill with task information.
  7. Go to the Macro Assignment form by clicking Task Assignment.
  8. Enter the following in the Macro Filename field on the Macro Assignment form:
  9. Click Save.
Perform the following steps to activate the customized macro for order detail display:
  1. Ensure that you are authorized to replace the ORD_DSP_PEN macro.
  2. Open the Net.Commerce Administrator using your browser.
  3. On the task bar, click Site Manager.
  4. Click Task Management to display the Task Management form.
  5. Select the ORDER task type from the Select Task Type drop-down list. A list of tasks appears in the bottom frame.
  6. Select the ORD_DSP_PEN task name from the list. The fields automatically fill with task information.
  7. Go to the Macro Assignment form by clicking Task Assignment.
  8. Enter the following in the Macro Filename field on the Macro Assignment form:
  9. Click Save.

Please refer to the Net.Commerce version 3.2 documentation for additional information about the assignment of API process tasks and macros.