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.
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):
- Ensure that you are authorized to replace the DO_PAYMENT task.
- Register the Merchant/400 Payment API in Net.Commerce.
- Insert a record into the APIS database table that resides in your Net.Commerce instance library. Example values are shown in the table below:
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.
- Override the DO_PAYMENT process with the Merchant/400 API.
- Insert a record into the TASK_MER_OF table within your instance library. Example values are shown below:
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.
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:
- Ensure that you are authorized to replace the DO_PAYMENT error macro.
- Open the Net.Commerce Administrator using your browser.
- On the task bar, click Site Manager.
- Click Task Management to display the Task Management form.
- Select the API task type from the Select Task Type drop-down list. A list
of tasks appears in the bottom frame.
- Select the DO_PAYMENT task name from the list. The fields automatically
fill with task information.
- Go to the Macro Assignment form by clicking Task Assignment
and then API Error Macro....
- Enter the following in the Macro Filename field on
the Macro Assignment form:
- The Merchant/400 Net.Data macro name
err_do_payment.ncimrc.d2w
, or
- The macro name of a do_payment error Net.Data macro that you have tailored
to your individual requirements.
- Click Save.
Perform the following steps to activate the customized macro for order acceptance:
- Ensure that you are authorized to replace the ORD_OK macro.
- Open the Net.Commerce Administrator using your browser.
- On the task bar, click Site Manager.
- Click Task Management to display the Task Management form.
- Select the ORDER task type from the Select Task Type drop-down list. A list
of tasks appears in the bottom frame.
- Select the ORD_OK task name from the list. The fields automatically
fill with task information.
- Go to the Macro Assignment form by clicking Task Assignment.
- Enter the following in the Macro Filename field on the Macro
Assignment form:
- The Merchant/400 Net.Data macro name
orderacpt.ncimrc.d2w
, or
- The macro name of an order acceptance Net.Data macro that you have tailored
to your individual requirements.
- Click Save.
Perform the following steps to activate the customized macro for order detail display:
- Ensure that you are authorized to replace the ORD_DSP_PEN macro.
- Open the Net.Commerce Administrator using your browser.
- On the task bar, click Site Manager.
- Click Task Management to display the Task Management form.
- Select the ORDER task type from the Select Task Type drop-down list. A list
of tasks appears in the bottom frame.
- Select the ORD_DSP_PEN task name from the list. The fields automatically
fill with task information.
- Go to the Macro Assignment form by clicking Task Assignment.
- Enter the following in the Macro Filename field on the Macro
Assignment form:
- The Merchant/400 Net.Data macro name
orderdspp.ncimrc.d2w
, or
- The macro name of an order acceptance Net.Data macro that you have tailored
to your individual requirements.
- Click Save.
Please refer to the Net.Commerce version 3.2 documentation for additional information
about the assignment of API process tasks and macros.