Overview

Documentation ( Version: 1.00 )
Updated: 1st September, 2023

General overview

Connect effortlessly through our system. Link apps and data sources, automate tasks, and enjoy smooth workflows with ease.Receive payments directly into your personal account using UniquePay BD's payment automation software. No need to handle payments manually anymore.

Setup your panel

Checkpoint Tips:

Setup your Mobile App

Checkpoint Tips:

Payment Process

We have made Live environment to process payments.

Live Environment

All the transaction made using this environment are counted as real transaction, URL starts with https://pay.zitelly.com/request/payment/create

REST API
API Endpoint (Live Environment): https://pay.zitelly.com/request/payment/create
Method: POST

Request Parameters

Param Name Data Type Description
cus_name string (50) Mandatory - This parameter will be returned only when the request successfully initiates
cus_email string (50) Mandatory - This parameter will be returned only when the request successfully initiates
success_url string (100) Mandatory - This parameter will be returned only when the request successfully initiates
cancel_url string (100) Mandatory - This parameter will be returned only when the request successfully initiates
amount string (50) Mandatory - This parameter will be returned only when the request successfully initiates

Request Headers

Param Name Data Type Description
Content-Type application/x-www-form-urlencoded Mandatory
app-key string (50) Mandatory Your API KEY
secret-key string (50) Mandatory Your SECRET KEY
host-name string (50) Mandatory Valid Domain

Returned Parameters

In GET Request

Param Name Data Type Description
transactionId string (50) Receive it by $_GET['transactionId'] in your success and cancel url
paymentAmount string (50) Receive it by $_GET['paymentAmount'] in your success and cancel url
paymentFee string (50) Receive it by $_GET['paymentFee'] in your success and cancel url
success int (2) Receive (0/1) by $_GET['success'] in your success and cancel url
p_type string (50) Receive it by $_GET['p_type'] in your success url

Create Payment Request

Security Check Points:

  • Your Public IP must be registered at SuperPay BD Live System

Payment Create code


<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://pay.zitelly.com/request/payment/create',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => false,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => array('cus_name' => 'demo','cus_email' => 'demo@gmail.com','amount' => '10','success_url' => 'success.php','cancel_url' => 'cancel.php'),
  CURLOPT_HTTPHEADER => array(
    'app-key: #########',
    'secret-key: ######',
    'host-name: ######',
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
?>
                                 

<?php
$client = new Client();
$headers = [
  'app-key' => '#####',
  'secret-key' => '#####',
  'host-name' => '######',
];
$options = [
  'multipart' => [
    [
      'name' => 'cus_name',
      'contents' => 'demo'
    ],
    [
      'name' => 'cus_email',
      'contents' => 'demo@gmail.com'
    ],
    [
      'name' => 'amount',
      'contents' => '10'
    ],
    [
      'name' => 'success_url',
      'contents' => 'success.php'
    ],
    [
      'name' => 'cancel_url',
      'contents' => 'cancel.php'
    ]
]];
$request = new Request('POST', 'https://pay.zitelly.com/request/payment/create', $headers);
$res = $client->sendAsync($request, $options)->wait();
echo $res->getBody();

?>
                                 

const axios = require('axios');
const FormData = require('form-data');
let data = new FormData();
data.append('cus_name', 'demo');
data.append('cus_email', 'demo@gmail.com');
data.append('amount', '10');
data.append('success_url', 'success.php');
data.append('cancel_url', 'cancel.php');

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://pay.zitelly.com/request/payment/create',
  headers: { 
    'app-key': '#####', 
    'secret-key': '####', 
    'host-name': '###', 
    ...data.getHeaders()
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});
                                    
                                 

Response from GATEWAY

Response:

  • After Successfull Payment you will be redirect to : success.php?transactionId=******&paid_by=***&paymentAmount=**.**&paymentFee=**.**&success=1&p_type=****
  • paid_by can be bkash,nagad,rocket,cellfin,upay,ibl,ebl,sonali,paypal,mastercard,basic,jamuna,ific etc.
  • After failure of payment you will be redirect to : cancel.php?transactionId=******&paymentAmount=**.**&paymentFee=**.**&success=0

Verify Payment

Payment verify code


<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://pay.zitelly.com/request/payment/verify',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => false,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => array('transaction_id' => 'JJTG987652'),
  CURLOPT_HTTPHEADER => array(
    'app-key: ##########',
    'secret-key: #####',
    'host-name: ###',
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
?>
                                 

<?php
$client = new Client();
$headers = [
  'app-key' => '#########',
  'secret-key' => '#####',
  'host-name' => '###',
];
$options = [
  'multipart' => [
    [
      'name' => 'transaction_id',
      'contents' => '####'
    ]
]];
$request = new Request('POST', 'https://pay.zitelly.com/request/payment/verify', $headers);
$res = $client->sendAsync($request, $options)->wait();
echo $res->getBody();

?>
                                 

const axios = require('axios');
const FormData = require('form-data');
let data = new FormData();
data.append('transaction_id', '#####');

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://pay.zitelly.com/request/payment/verify',
  headers: { 
    'app-key': '#########', 
    'secret-key': '########', 
    'host-name': '######', 
    ...data.getHeaders()
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

                                    
                                 

Verify Payment Response

Response:

{"cus_name":"y8vf","cus_email":"f@m.m","amount":"10","transaction_id":"JJTG987652","status":"1","message":"success"}

All Modules