Synchronous


   Merchant needs to be PCI compliant in order to perform synchronous payment.

In a synchronous workflow the payment data are directly sent to the server with initial payment request. That means that the transaction can be processed straight away.

Your request has to include the following information:

  • - Authentication Credentials
  • - Type and amount of transactions
  • - Payment information like card details, Payment Mode and Payment Brand

For our Synchronous Workflow REST API you can use the following types of initial payments:


Preauthorization (PA):

Preauthorization request has to be sent to our REST endpoint i.e. /transactionServices/REST/v1/payments using POST method.

The paymentType for this request will be PA.

You can also place a capture transaction request against a successful PA using our Backoffice APIs.


Debit (DB):

Debit request has to be sent to our REST endpoint i.e. /transactionServices/REST/v1/payments using POST method.

With a DB request a successfully authorized transaction gets captured immediately.

The paymentType for this request will be DB.



In our API Specifications you can find a full list of parameters that can be sent in the initial request.


   Merchant needs to set Authentication token in header while posting request. To generate authentication token, please refer Auth token API.

Sample Request


Sample Response


Hashing Rule

is supporting MD5 Cryptographic Hash for the authenticity of payment request send to the server.


Below is the description of fields use for generating checksum.

  • memberId <Merchant ID as shared by >
  • secureKey <Secure Key that can be generated through 's dashboard>
  • merchantTransactionId <Unique transaction ID prived by merchant>
  • amount <Amount of transaction>

How to generate Checksum ?

Checksum has to be calculated with following combination and need to be send along with the authentication parameters in each server-to-server request:
<memberId>|<secureKey>|<merchantTransactionId>|<amount>


How to redirect to the bank page to complete the payment ?

  1. The transaction status is "P" (Pending), which means the customer must be redirected to the bank page to complete the payment.
  2. To do this, you need to create an HTML form with the provided redirect.url as the action, and include the parameters (like TermURL and MD) as hidden fields. This form should then be automatically submitted via JavaScript.

Steps to Redirection:

  1. Create an HTML form with the POST method.
  2. Set the action URL to: https://test.paymentz.com/transaction/Pz3DSecure.jsp?trackingId=220769
  3. Add the required hidden parameters: TermUrl: https://test.paymentz.com/transaction/PZFrontendServlet?trackindId=220769

HTML Code Snippet

                   <!DOCTYPE html> 
                   <html>
                    <head>
                       <title>Redirecting to the Bank...</title>
                        <meta charset="UTF-8">
                    </head>
                    <body onload="document.forms[0].submit();">
                        <form action="https://test.paymentz.com/transaction/Pz3DSecure.jsp?trackingId=220769" method="POST">
                            <input type="hidden" name="TermUrl" value="https://test.paymentz.com/transaction/PZFrontendServlet?trackindId=220769">
                            <input type="hidden" name="MD" value="1234">
                            <noscript>
                               <p>If you are not redirected automatically, click the button below:</p>
                                <button type="submit">Proceed to Bank</button>
                            </noscript>
                        </form>
                    </body>
                    </html>
                

Standard Notification/ Callback

Checksum has to be calculated with following combination.
<trackingid>|<orderid>|<amount>|<short status of transaction>|<secret key>

Example :
77251|011E1D8A5C034|156.00|N|<merchant secret key>


Sample Code


Payment Modes and Brands

Find below the list of payment modes and brands for synchronous workflow.

Show all modes & brands

ModeBrand