Integration Document

Sathapana Connect Integration Documents

Sathapana Connect is the transparent gateway that proxies into MPGS within the bank in order to associate with PCI Compliance.

Version - 1.0.5

Released - September 02, 2022

Table of Contents

1. Introduction
2. Sequence Flow
   • One time
   • Recurring or Card on File
3. Get started
4. How to integrate
   1. One-time payment ( Full or Partial )
   2. Recurring or Card on File
   3. Capture, Void & Refund

1. Introduction

Sathapana Bank Connect allows Partners to integrate and be transparent to the gateway below

Partner can use their own iframe & Design as they wanted.

2. Sequence Flow by Steps

One-time pay, authorize or capture

• Step 1: Customers place an order on your website or app.

• Step 2: You initiate an order from your server/app

• Step 3: Your server created a session with Sathapana Bank Connect.

• Step 4: Your website or app renders iframe that builds with Tokenex ( hosted iframe) and gets the Tokenex iframe response
• Step 5: Customer fills out Card Number.
• Step 6: After filling Tokenex response data into the iframe
• Step 7: Update the token response from Tokenex into the session with Sathapana Bank Connect API
• Step 8: Authenticate 3ds and 3ds2 with Sathapana Bank Connect Api
• Step 9: Authorize or Pay with Sathapana Bank Connect API
• Step 10: (only if you authorize instead of pay in step 9) Capture with Sathapana Bank Connect API

Recurring or Card on File

• Step 1: Customers place an order on your website or app.
• Step 2: You initiate an order from your server/app
• Step 3: Your server created a session with SPNB Connect.
• Step 4: Adding agreementId into session with SPNB Connect ( agreement id should be random per customer)
• Step 5: Your website or app renders iframe that build with Tokenex ( hosted iframe) and get the tokenex iframe response
• Step 6: Customer fills Card Number.
• Step 7: After filling Tokenex response data into the iframe
• Step 8: Update the tokenex response from tokenex into session with SPNB Connect api
• Step 9: Authenticate 3ds and 3ds2 with SPNB Connect Api
• Step 10: Verify the transaction with session by SPNB Connect Api

3. Get started

Before we get started partner needs to get ready and have this information.

Credentials provided by Sathapana

• Tokenex Token
• Tokenex Id
• Merchant Username
• Merchant Password
• Merchant Id

Additional tech stacks

• Server
• Custom iframe with tokenex (see: how to)
• https domain for production

4. How to integrate

For developers, if you are familiar with swagger and understand the full flow can skip this step.

• One-time payment ( Full or Partial )
• Recurring or Card on File
• Capture, Void & Refund