NomuPay

STEP 1

Obtain a merchantID and merchantSecret from NomuPay. If you intend to send merchantPwd, please configure it on your Merchant Account with NomuPay.

STEP 2

Activate the NomuPay gateway and enter your credentials.

Steps 3-5 can be skipped if using CheckoutChamp hosted pages

STEP 3

Add the hidden input browserData inside of the same form as the card input.

<input type="hidden" name="browserData" value="" id="browserData">

STEP 4

Add this script to your page before the closing body tag.

Script to get browserData:
<script type="text/javascript">
    const navigator = window.navigator;
    const browserData = {
        acceptHeader: 'application/json',
        colorDepth: screen.colorDepth,
        javaEnabled: navigator.javaEnabled(),
        javaScriptEnabled: true,
        language: navigator.language,
        screenHeight: screen.height,
        screenWidth: screen.width,
        timeZoneOffset: (new Date()).getTimezoneOffset().toString(),
        userAgent: navigator.userAgent
    };
    document.getElementById('browserData').value = JSON.stringify(browserData);
</script>

STEP 5

If using Secure 3DS be sure the checkout page supports the challenge requests

Direct API 3DS Instructions

REFUNDS

Refunds require special consideration

Be familiar with standard refund instructions here

It is highly recommended to refund entire orders instead of transactions. Refunding an entire order handles the difference between settled and unsettled transactions at NomuPay. Refunding a sale transaction, especially in the first 24-36 hours, may fail because it is not yet settled at NomuPay. If a refund fails then do attempt to void the sale.

Similar instructions should be followed when refunding from Shopify. It is highly recommended to refund an entire order instead of individual line items. There are certainly instances when a line item refund is necessary but be aware of 2 considerations:

• NomuPay does not allow a partial void (cancellation) of an unsettled transaction. A partial refund must be a refund. And that refund will fail until the sale is settled. CheckoutChamp will automatically re-attempt that refund for 3 days (see notes about the refund queue in the standard instructions). Consumers will not see the refund until it is successful.

• NomuPay only allows one partial refund (line item) per day because that refund must settle before the remaining balance can be validated on subsequent partial refunds. This can cause multiple line item refunds to be spaced out over several days (see notes about the refund queue in the standard instructions).

If a refund or cancellation is done in the MMS portal then the transaction should be refunded in CheckoutChamp using the Externally Refunded checkbox.