Payment Gateway Integration
Getting Started
Here’s how you can get started :
- Sign Up for an Instant Test Account and get login credentials through email. Post login get Test Merchant Key and credentials for test
- To activate Account ,Fill in the details and submit documents
- Add your bank account details for payouts
- Integrate your website/app with Payment Gateway (PG). Click on the below through Integrations Link
- Get Merchant ID and Secret Key
- Fire a Test Transaction
- Go Live
- Get payouts of the transactions in your bank account
Introduction
Secure and Hassle-Free Payment Gateway Service for Banks, Merchants and PSPs.
- PG Application is EMVCo Certified for MPI 2.0,Visa Certified for 3DSecure 2.0, MasterCard Certified for 3DSecure 2.0 and hosted on PCI-DSS 3.2.1 Certified environment.
- Offer your customers quick & easy Payment experience with options like Payment Links, Recurring Payments, Multi-Currency Options , Customised Local Language Pages to name a few.
- With PG Application, one can get started quickly with a wide range of integrations. Integrate with wide range of Server Plug-ins ,SDK, Shopping Carts and Hosted pages.
How it works behind the scenes
Transaction Flow
Transaction Flow of Payment Gateway is as below:
- Step 1: Customer adds products to his cart and proceeds to checkout by clicking on payment option on your website/app.
- Step 2: Merchant will sent the Token request to gateway ( Payment Gateway Application) to the get payment ID and the URL (Hosted page URL).
Below is the URL for redirecting the customer to the Gateway payment Page : https://test-vegaah.concertosoft.com/CORE_2.2.2/transaction/jsonProcess/JSONrequest.This way Merchant will redirect the customer to VegaaH payment secure page with unique transaction ID received in the first leg of response. - Step 3: Customer enters card/other payment details on Payment Secure page.
- Step 4: PG Application validates Merchant request fields and card details and also does the risk check.
- Step 5: PG Application then interfaces with Interchange for the 3D secure authentication.
- Step 6: Once authentication step is completed, PG Application routes the transaction to Bank for authorization.
- Step 7: Upon receiving the response from bank, PG formats the response and provides to the merchant who in turn shares with Customer.
Transaction Types supported
- Purchase (Action Code 1) :
Purchase transactions are transactions which are immediately flagged for settlement post submission. Here customer’s amount is immediately debited from bank account. - Authorization (Action Code 4) :
Here the customer amount is not debited immediately from bank account , rather the amount is blocked till the reference transaction is not requested for capture.Transaction authorizations are authorized immediately but are not flagged for settlement. These transactions must be flagged for settlement using the Capture transaction type. - Capture (Action 5) :
This transaction type is applicabe only for Authorization Transaction. Capture flags the authorized transactions for settlement.Point to note is that the amount submitted in Capture can be equal to or less than that of original authorization transaction. - Void Transactions of Purchase,Refund,Authorisation (Action Code -3,6,9) :
Void Transactions will cancel an existing sale or captured authorization. In addition, non-captured authorizations can be voided to prevent any future capture.Note :-Voids can only occur if the transaction has not been settled. - Refund/Credit (Action Code -2) :
Transaction refunds will reverse a previously settled or pending settlement transaction. If the transaction has not been settled, a transaction void can also reverse it. - Transaction Inquiry (Action Code 10) :
Allows merchants to quickly and easily retrieve detailed information about past transactions.
Payment Methods supported
- Credit Cards/EMI
- Debit Cards
- NetBanking
- Wallets
- UPI
Key Features
- Subscription based :
Manage your recurring payments by your customers with the subscription/recurring based payment feature. - Link Based Payments :
Generate Payment link through portal or directly through API and share with customers via an email, SMS, messenger, chatbot etc - Customised local Language :
Supports customization of portal and hosted page in local language - Express Checkouts :
Enable tokenization of card details for express checkouts - Multiple Currencies :
Enable merchants to collect payment in multiple currencies - Dynamic routing :
Route transactions based on multiple business logic in order to enable higher success rate and be save on costs - Security & Certifications :
PG Application is EMVCo Certified for MPI 2.0,Visa Certified for 3DSecure 2.0, MasterCard Certified for 3DSecure 2.0 and hosted on PCI-DSS 3.2.1 Certified environment.
How to Integrate
Merchant Integrations
Server Plugins :
- Wide range of server plug-ins available . They are Java, .net, PHP, Ruby,Angular,NodeJs, Phython, React
- Merchants can integrate their apps with SDK Integrations availale for-Android, Flutter, Ionic, Cordova,IOS, React Native, Kotlin
- Shopping Carts- PG Application supports integrations with major shopping Carts :-Magento, BigCommerce, PrestaShop,Joomla, Woo, Cs.Cart, Shopify, openCart
Type of Integrations
- Hosted Integration :
Here, you can choose to redirect your customers to a standard hosted page or customised hosted page according to your website look and feel. - Direct Integrations :
Merchants who have the necessary security compliance (PCI DSS) can choose to have direct integration with PG Application. In such a case, their customers need leave their website and the card details can be captured in their own website payment page.
Test your payment flow
Test your transactions with below credentials and process
Test Credentials :
Test Data | Value |
Card Holder Name | TEST TEST (should be same as first leg request) |
Card Number | 4111 1111 1111 1111 |
Card Expiration Date | 10/2030 |
CVV | 123 |
Test Data | Value |
Card Holder Name | Test Test (should be same as first leg request ) |
Card Number | 5179 0800 0000 0006 |
Card Expiration Date | 10/2030 |
CVV | 123 |
Test Data | Value |
OTP Value | 112260 |
Purchase API :Purchase (Action Code 1) -Purchase transactions are transactions which are immediately flagged for settlement post submission. Here customer’s amount is immediately debited from bank account. Type: POST Test Server Link: Production Server Link, Request Parameters, Response Parameters, Sample Request , Sample Response, CheckAPItxnStatus
- :POST Test Server Link:Production Server Link, Request Parameters, Response Parameters, Sample Request , Sample Response, CheckAPItxnStatusAuthorization API
- :POST Test Server Link: Production Server Link, Request Parameters, Response Parameters, Sample Request , Sample Response, CheckAPItxnStatusCapture API
Void Transactions API :POST Test Server Link: Production Server Link, Request Parameters, Response Parameters, Sample Request , Sample Response, CheckAPItxnStatus
Refund API :POST Test Server Link:Production Server Link, Request Parameters, Response Parameters, Sample Request , Sample Response, CheckAPItxnStatus
Check Transaction API:This API enables Merchant to check the status of the transaction. Method Type : POST Test Server: Link Production Server Link, Request Parameters, Response Parameters. Sample Request, Sample response , CheckAPItxnStatus
Generate Payment Link API:This API enables merchant to generate Payment link through portal or directly through API and share with customers via an email, SMS, messenger, chatbot etc.Method Type : POST Test Server: Link Production Server Link, Request Parameters, Response Parameters. Sample Request, Sample response , CheckAPItxnStatus
Troubleshoot
Please find the response codes inorder to trouble shoot incase of any errors
Go-Live
- Start collecting payments from customers through PG Application.
- If you have signed up and activated your account, and completed the integration and testing, then you can go-live with PG Application in production environment.
POST Purchase API
https://test-vegaah.concertosoft.com/CORE_2.2.2/transaction/jsonProcess/JSONrequest
- Purchase (1) : Purchase transactions are submitted and immediately flagged for settlement. Here customer amount is immediately debited from bank account
HEADERS
Body Raw
{
"tranId":"2108309171610733245",
"terminalId": "AsureTTest",
"password": "password",
"action": "1",
"trackid": "101010",
"amount": "1.00",
"address": "Mahape",
"customerIp": "10.10.10.10",
"merchantIp": "10.10.10.109",
"city": "navi mumbai",
"zipCode": "400710",
"state":"MH",
"country": "BS",
"contactNumber":"9892993905",
"customerEmail": "vishal.utekar@concertosoft.com",
"cardHolderName": "Demo Test",
"udf1":"test5",
"udf2":"test5",
"udf3":"test5",
"udf4":"test5",
"udf5":"test5",
"currency":"BSD",
"requestHash":"635887b0e0f3e0bc23c0235ec28ed8b1142f727347674a39a5279662cab3f067"
}
POST Authorization API
https://test-vegaah.concertosoft.com/CORE_2.2.2/transaction/jsonProcess/JSONrequest
- Authorization (4) : Transaction authorizations are authorized immediately but are not flagged for settlement. These transactions must be flagged for settlement using the capture transaction type. Here the customer amount is not immediately debited from bank account , the amount is locked till the reference transaction is not requested for capture.
HEADERS
{
"terminalId": "DemoTest",
"password": "password",
"action": "1",
"trackid": "101010",
"amount": "1.00",
"address": "Mahape",
"customerIp": "10.10.10.10",
"merchantIp": "10.10.10.109",
"city": "navi mumbai",
"zipCode": "400710",
"state":"MH",
"country": "IN",
"contactNumber":"9892991205",
"customerEmail": "vishal.utekar@concertosoft.com",
"udf1":"test5",
"udf2":"test5",
"udf3":"test5",
"udf4":"test5",
"udf5":"test5",
"currency":"INR",
"requestHash":"cdcd15bf45e243b92d690fe7d9d9dbe6c3bef6d24fd63975aabfb24d886eb24d
"
}
POST Capture API
https://test-vegaah.concertosoft.com/CORE_2.2.2/transaction/jsonProcess/JSONrequest
- Capture (5) : Transaction captures flag existing authorizations for settlement. Only authorizations can be captured. Captures can be submitted for an amount equal to or less than the original authorization.
HEADERS
{
"terminalId": "DemoTest",
"password": "password",
"action": "5",
"trackid": "101010",
"amount": "1.00",
"address": "Mahape",
"customerIp": "10.10.10.10",
"merchantIp": "10.10.10.109",
"city": "navi mumbai",
"zipCode": "400710",
"state":"MH",
"country": "IN",
"contactNumber":"9892991205",
"customerEmail": "vishal.utekar@concertosoft.com",
"udf1":"test5",
"udf2":"test5",
"udf3":"test5",
"udf4":"test5",
"udf5":"test5",
"currency":"INR",
"requestHash":"cdcd15bf45e243b92d690fe7d9d9dbe6c3bef6d24fd63975aabfb24d886eb24d
"
}
Example Request Purchase API
–header ‘Content-Type: application/json’ \
–data-raw ‘{
“tranId”:”2108309171610733245″,
“terminalId”: “AsureTTest”,
“password”: “password”,
“action”: “1”,
“trackid”: “101010”,
“amount”: “1.00”,
“address”: “Mahape”,
“customerIp”: “10.10.10.10”,
“merchantIp”: “10.10.10.109”,
“city”: “navi mumbai”,
“zipCode”: “400710”,
“state”:”MH”,
“country”: “BS”,
“contactNumber”:”9892993905″,
“customerEmail”: “vishal.utekar@concertosoft.com”,
“cardHolderName”: “Demo Test”,
“udf1″:”test5”,
“udf2″:”test5”,
“udf3″:”test5”,
“udf4″:”test5”,
“udf5″:”test5”,
“currency”:”BSD”,
“requestHash”:”635887b0e0f3e0bc23c0235ec28ed8b1142f727347674a39a5279662cab3f067″
}’
EXAMPLE RESPONSE 200ok
EXAMPLE RESPONSE 200ok
{
"result": null,
"responseCode": "001",
"authcode": null,
"tranid": null,
"trackid": null,
"terminalid": null,
"udf1": "test5",
"udf2": "test5",
"udf3": "test5",
"udf4": "test5",
"udf5": "test5",
"rrn": null,
"eci": null,
"subscriptionId": null,
"trandate": null,
"tranType": null,
"integrationModule": null,
"integrationData": null,
"payid": "2119615106314157960",
"targetUrl": "https://test-vegaah.concertosoft.com/CORE_2.2.2/direct.htm?paymentId=",
"postData": null,
"intUrl": null,
"responseHash": null,
"amount": null,
"cardBrand": null,
"cardToken": null,
"maskedCard": null,
"aRes": null
}
EXAMPLE REQUEST AUTHORIZATION API
{
"result": null,
"responseCode": "001",
"authcode": null,
"tranid": null,
"trackid": null,
"terminalid": null,
"udf1": "test5",
"udf2": "test5",
"udf3": "test5",
"udf4": "test5",
"udf5": "test5",
"rrn": null,
"eci": null,
"subscriptionId": null,
"trandate": null,
"tranType": null,
"integrationModule": null,
"integrationData": null,
"payid": "2119615106314157960",
"targetUrl": "https://test-vegaah.concertosoft.com/CORE_2.2.2/direct.htm?paymentId=",
"postData": null,
"intUrl": null,
"responseHash": null,
"amount": null,
"cardBrand": null,
"cardToken": null,
"maskedCard": null,
"aRes": null
}
EXAMPLE RESPONSE CAPTURE API
curl –location –request POST ‘https://test-vegaah.concertosoft.com/CORE_2.2.2/transaction/jsonProcess/JSONrequest’ \ –header ‘Content-Type: application/json’ \ –data-raw ‘{ “terminalId”: “DemoTest”, “password”: “password”, “action”: “5”, “trackid”: “101010”, “amount”: “1.00”, “address”: “Mahape”, “customerIp”: “10.10.10.10”, “merchantIp”: “10.10.10.109”, “city”: “navi mumbai”, “zipCode”: “400710”, “state”:”MH”, “country”: “IN”, “contactNumber”:”9892991205″, “customerEmail”: “vishal.utekar@concertosoft.com”, “udf1″:”test5”, “udf2″:”test5”, “udf3″:”test5”, “udf4″:”test5”, “udf5″:”test5”, “currency”:”INR”, “requestHash”:”cdcd15bf45e243b92d690fe7d9d9dbe6c3bef6d24fd63975aabfb24d886eb24d ” }’ 200ok