Table of Contents

Web Integration

You can easily accept payments from your customers in a hassle-free and secure way with PayGoal. Your customers get a easy, user-friendly and streamlined flow with the ‘Checkout’ form for initiating payments. You can submit additional fields, visible or hidden, along with the form.

With the below mentioned sample code, PayGoal ‘Checkout’ options will be passed as the HTML data attributes.

Once the checkout process is complete, an additional field <name=id> will be added to the form containing the script tag. Further, the form is submitted automatically. With the authorisation of the payment made, the form along with the Paygoal_payment_id to the action URL.

In the sample code mentioned below, replace the URL with the success callback URL of your website.

Step I - Integration

Web integration is the easiest and the simplest way to integrate PayGoal Payment Services on your Website. While using this mode of integration the customer will be redirected from your checkout page to PayGoal’s payment page. Our payment page is inclusive of all the features and built-in support to collect payment details for all payment mode such as Credit and Debit Cards, Net-banking, UPI wallets etc.

The merchants can experience a hassle-free journey without any worries as our Payment page is hosted at PayGoal Servers which are PCI-DSS compliant (Payment Card Industry Data Security Standard).

Step II - Generate Test Credentials

Please follow the steps mentioned below in order to generate the test credentials:

1. Login to your merchant account
2. Click on My Account Tab
3. Click on My Profile
4. Click on integration tab
5. You can find Salt, PAY_ID and Request URL value under the Integration Tab

Alternatively, you can contact the integration support team at tech@paygoal.in to get the keys.

Step III - Checkout API

Create the order form the below mentioned Request URLs -

Step IV - Generate Secure Hash

Every request passed is assisted by a secure Hash that verifies the request’s Integrity as well as the identity of the merchant. The secure Hash algorithm is SHA-256.

To generate secure Hash, use the following method:

1. Collect all the request parameters that are to be shared with PayGoal and organize them in ascending order according to the name of each field.
2. Prepare a String of these sorted name value parameters with Tiled (~) as the separator.
3. Next is to append the Salt at the end of the parameter string given by PayGoal Payment Gateway to you. After appending you will receive the following output (If salt is 6615f2c6e57743d3)

   Note: Please append the salt in lower case without any separator after the last value.

4. After completing the above-mentioned process, you will have to call SHA 256 algorithm and pass the parameter string to the same and the SHA will return you the desired result as below
   
   Hash value= {6797f1842deb4f3ebaead53e1bafd5a535d322b9fa3893f201fdb03933eeae09}
5. Now you must convert the generated value to the Upper Case, and you will get the final result as hash value
   
   Hash value = 6797F1842DEB4F3EBAEAD53E1BAFD5A535D322B9FA3893F201FDB03933EEAE09

Step V - Submit Form

Once the checkout form is prepared, the user can click on the submit button or the merchant can implement an automatic javascript for form auto submit and user will be redirected to PayGoal Payment Page.

1. In order to achieve better success rate, PayGoal recommends that you redirect customers to the Payment Gateway in the same browser window.
2. Amount format should be in the least parts without decimals like INR 1500.75 will be written as 150075 and INR 1.00 as 100

Step VI - Testing

You can use the below mentioned cards in your test suite

Step VII - Validating the response

It is mandatory for the merchant application to validate the transaction response in the status response.

This can be done as follows:

Using the response parameters, you are supposed to Match the response hash that is present in the response against the merchant application calculated hash value.

In case there is a mismatch in the merchant hash and response hash, that particular transaction must not be considered a successful transaction.

For successful transaction RESPONSE_CODE is 000 and STATUS is marked as “Captured” or “Approved”.

Please ensure that response Hash is validated in your production system.

Step VIII - Request Parameters

*(Abbreviation NU – Numeric, CH – Character, AN – Alphanumeric)

Response Parameters

Step IX - Response Code

For successful transaction RESPONSE_CODE is 000. Any other response code other than 000, shall be treated as unsuccessful transaction.