banner bkgd.png

DOCUMENTATION

Asynchronous Notification Merchant Implementation Guide

version 2.0 | publishing date: 10/07/2019 

Table of content:

1. Introduction

2. Required Information for Asynchronous Notification

3. Notification Flow

1. Introduction

Octo3’s e-Commerce Payment Service (or simply the “e-Commerce Payment Service”) provides an efficient, secure and easy-to-use payment integration solution to enable merchant systems with online payment capability.  Built on top of Octo3 Platform, the e-Commerce Payment Service enables online payments to be conducted with high speed and high security.

This document provides technical guidelines on setting up Octo3 Platform’s asynchronous notification via HTTP/HTTPS POST method and describes the specifications in detail.

2. Required Information for Asynchronous Notification

Merchant are required to provide the data feed URL to the Payment Service Provider. Once set up, the Octo3 platform will deliver the notification data to the URL provided. Please make sure there is no firewall rule denying Octo3 platform for access to this URL.

3. Notification Flow

The process flow for asynchronous notification is depicted in Figure 1. The Payments Platform delivers the asynchronous notification via HTTP/HTTPS POST method.

  1. When the status of a transaction is marked as “ACCEPTED”, "FAILED", "REJECTED", "DECLINED", "VOIDED", "ERROR", and "CANCELLED", Octo3 Platform sends notifications data to the URL provided by Merchant.

  2. Merchant receives the asynchronous notification and return a plain text response with text “ACK” to Octo3 Platform for all status (refer to above item (1)).

  3. Octo3 Platform marks the transaction as successfully notified.

  4. If Octo3 Platform does not receive the text “ACK”, it will actively retry until reaching the maximum failure rate.

Sample form post of asynchronous notification

Asynchronous notification is using HTTP/HTTPS form post method to notify merchant. Here is the sample of HTTPS form post message to merchant data feed URL:

List of Applicable Data Fields
Mandatory Notes

By combining advanced technologies with the latest innovation in security and regulatory requirements, Octo3 is the right solution provider to inspire your organization to deploy your latest business strategy in the shortest possible time. Octo3 employs a comprehensive range of Payment and Financial Infrastructure related products 

Rm20, Unit 917, 9/F, Block B, Sea View Estate, 2-8 Watson Road, Hong Kong

Linkedin.png

© 2021 by octo3. All rights reserved.