This document details the process to integrate the code supplied by Noca with the Marketplace portal. Upon completion of integration, the online marketplace will be able to offer its merchants Noca’s payment system. To become a Marketplace and enable this functionality please email merchants@noca.com. This document describes the various components of the code including the HTML and javascript that are shipped as part of the integration module.
Marketplace for Merchants currently involves only HTML and Javascript only, thus obviating any need for platform specific code. A web service will be available soon.
The following steps are required to signup merchants with Noca.
1. Create a gif (with HTML code) or button that the user will click on to use the Noca Payment System.
You are free to resize the gifs to fit with your stylesheet/look and feel of your website as long as you adhere to the Merchant Agreement terms and conditions.
2. Install and configure the API
The API basically consists of using a form to POST the values of variables from the Marketplace site to Noca.
The HTML integration form must be filled out and put on merchant signup page. All variables except for the first name and last name are required.
Moving onto the production environment involves changing the form destination (in bold). You will receive the URL after a successful post to the sandbox.
merchantIdentifier
How the Marketplace uniquely identifies the Merchant.
merchantID
The identity of the merchant in Noca’s system–used for identifying the merchant when customers make payments.
What does a valid Routing Number look like?
Routing numbers are defined by the American Bankers Association, and have a specific mathematical formula, which we check (see http://en.wikipedia.org/wiki/Routing_transit_number). A good number to use for testing is a bank in Texas with an easy-to-remember number: 111000025.
What is my MfMMarketplaceID?
This is issued to you by Noca at the time you initially signup with us. As a Marketplace, the only time you’ll need to use this variable is when you’re signing up your merchants. When you go to create a payment/invoice for them, you use their Merchant ID. We know it came from you because we have them linked to you on our system.
What is the MfMMerchantIdentifier?
This is whatever sort of identifying value you use for the merchant internally at your site. The only reason it’s important to us is so we can return it to you, along with their newly-created Merchant ID.
When creating a payment, what do I set “formMerchantID” to?
You use the Merchant ID that we returned to you when you signed the merchant up. The payment process should look as though the merchant were generating the payment themselves – we know it’s really you, the Marketplace, because you’re linked on our system, but it should be transparent to the user.
Our payments engineering team is available anytime to help Marketplaces get up and running with this exciting API. Email integration@noca.com with your API questions, and we’ll be in touch straightaway.
