Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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