• Table of contents
• Programming Guide
  • Step-By-Step
  • Generate the form action URL
    • Input Parameters
    • Output Parameters
    • Code Snippets

Programming Guide¶

This guide describes how to make use of the NMI APIs for payment related transaction and it consists of 2 main parts:

• Step-By-Step - describes the
• API Reference - the detailed description of all the APIs mentioned in Step-By-Step

The demo application can be found here:

http://192.168.2.68/ukstore/nmi-sample/orders.jsp

Step-By-Step¶

Before begin, install the following libraries into your development environment (remove the old versions if exists):

• HttpCore 4.1.2
• HttpClient 4.1.2

Steps:

1. gather the

Generate the form action URL¶

Generates the form action URL which is needed in the self-hosted payment form.

Method Signature:

public static String getFormActionUrl(String orderId, String orderDescription, BigDecimal orderAmount, String returnUrl)

Input Parameters¶

• orderId - the unique ID for the order
• orderDescription - a simple description of the order
• orderAmount - the settlement amount of the order in 2 decimal places, e.g. 12.34
• returnUrl - the receipt URL

Output Parameters¶

Returns a form action URL

Code Snippets¶

    String orderId = request.getParameter("order-id");
    String orderDescription = request.getParameter("order-description");
    BigDecimal orderAmount = new BigDecimal(request.getParameter("order-amount"));
    String returnUrl = request.getParameter("return-url");

    String formUrl = PaymentUtils.getFormActionUrl(orderId, 
            orderDescription, 
            orderAmount, 
            returnUrl);