NorthStar Currency Iframe Integration

The NorthStar Iframe Integration is made to be very simple and straight-forward for NorthStar clients. The iframe will be embedded into your merchant code directly.

Step 1 - Iframe Integration Methods:

Data validation happens in real time and if an error occurs, users are given the option to manually fill the required data and proceed on with the transaction.

If there is no error, the user will proceed to the payment page where they have the option to use Credit Card or Wire payment. Payment options vary depending on currency.

Basic iframe code with merchant ID in the URL

You also have the option to pre-fill fields by passing it via the query string as parameters in the URL

The required fields will be different from client to client. NorthStar will provide you with the list of required fields for your integration.

If you choose to use the pre-filled option, below are the minimum required fields to pass through.

Variable	Data Type	Required	Example
first_name	string (20 chars)		Jane
last_name	string (20 chars)		Doe
email	email (50 chars)		jane.doe@test.com
country	string 3 chars - ISO 3 letter code		cny
total	float (2 decimal point)		100.99
invoice_number	string 20 chars) unique invoice_number from your system. This is also the ID we will postback to your system, so you can map and update the transaction accordingly]		tradeid234

Step 2 - Postback Notifications

Credit Card – When a Credit Card payment is settled to the merchant bank account, our system will POSTBACK and update your system with the provided URL given.

It will be a POST in the format of JSON datatype

e.g. of the post back sample data in JSON datatype {northstar_trade_id:”ab1234”,”method”:”cc”,”status”:”success”}

Let us know if these POSTBACK data is sufficient enough for your system, otherwise we can add as needed.

Wire Payment - When a Wire payment is settled to the merchant bank account, our system will POSTBACK and update your system with the provided URL given.

It will be a POST in the format of JSON datatype

e.g. of the POSTBACK sample data in JSON datatype {northstar_trade_id:”ab1234”,”method”:”wire”,”status”:”success”}

Let us know if these POSTBACK data is sufficient enough for your system, otherwise we can add as needed.