Quick Start

Set up your environment and use the EFTLink REST API to process your first payment by performing these tasks. The assumption is that you have access to EDelivery [https://edelivery.oracle.com/osdc/faces/SoftwareDelivery] and MOS [https://support.oracle.com/epmos/faces/PatchHome] where you can obtain the latest EFTLink releases and patch releases.

Prerequisites

Prerequisite	More Information
Install EFTLink	https://docs.oracle.com/cd/E69694_01/eftlink/pdf/200/eftlink-200-framework-ig.pdf
Install EFTLink REST API	Install EFTLink REST API
Setup authentication	Authenticate

Install EFTLink REST API

Artefacts: V20.0.0.xxx.zip (xxx denotes the final build number)

Installation Steps:

1. Extract V20.0.0.xxx.zip

2. Setup authentication

3. Run eftlink-rest-api.bat (Windows) or eftlink-rest-api.sh (Linux)

4. Run eftlink.bat

To setup your environment, you only need the different end point URLs of the services and the certificate to be imported to your trust store for authentication.

Depending on the programming language you used for your client application, you should be prepared to create a web socket client coded according to the JSON message structure of the services.

The brief sample code provided below is specifically for HTML 5.0/JavaScript 6 (ECMAScript 6).

Check to see if your browser supports the WebSocket transport:

 if ("WebSocket" in window) { ??? }

Create the WebSocket client connection:

  _client_ws = new WebSocket(???wss://localhost:8443/login");

Set up your callbacks:

Open the connection:

_client_ws.onopen = function() {

//Build your request body (JSON object)

//Send your request
_client_ws.send(json_object);
}

Receive messages:

_client_ws.onmessage = function(data) {
	//Process your message data
   //You will need to check for device requests to ensure that you can send a device response with the input required. 
   //The onmessage callback can be triggered multiple times during the transaction lifecycle.
	
	//Build your response JSON object
	
	//Send your response
	_client_ws.send(json_object);
}

Handle the close callback:

_client_ws.onclose = function() {
 	//Apply your close event logic
}

Handle the error callback:

 _client_ws.onerror = function() {
 	//Apply your error event logic
}