Overview
The module acts as a liaison between eGov apps and external payment gateways. It facilitates payments, reconciliation of payments, and lookup of transactions 'status'.
Pre-requisites
Before proceeding, make sure the following pre-requisites are met -
Knowledge of DIGIT applications is required.
Users should be aware of transactional steps in the DIGIT application.
Knowledge of JAVA and Spring Boot Framework
Key Functionalities
Payment Flow
Create
Transaction to be initiated with a call to the transaction/_create API, various validations are carried out to ensure the sanctity of the request.
The response includes a generated transaction id and a redirect URL to the payment gateway itself.
Redirect
Once the transaction completed by the user post redirection, the Payment gateway will send the status of the transaction.
If this is an HTTP POST call, we have to provide
/transaction/v1/_redirect
as the redirect URL.This endpoint will redirect to the appropriate URL that will handle the transaction update
Update
Once the transaction is completed by following the redirect URL,
transaction/_update
endpoint is to be called with the query params returned by the gateway.Various validations are carried out to verify the authenticity of the request and the status is updated accordingly.
If the transaction is successful, a receipt is generated for the same.
Search
Transactions can be queried based on several search parameters as detailed in the swagger YAML Check out Resources section.
...
amount: Amount of transactions.
cancel_url: URL to which payment gateway will send the status of the transaction if it is unsuccessful
currency: Currency type INR for Indian Rupee
language: Display Language on the payment gateway page.
merchant_id: merchant id provided by ccavenue.
order_id: Unique id generated by this service to identify the transaction
redirect_url: URL to which payment gateway will send the status of the transaction if it is successful
sub_account_id: Key to identify the bank account to deposit the funds.
Reference Docs
Doc Links
TitleĀ | Link |
Code Repository | |
Configuring Gateway |