New v3 apis #47

soumyaa13 · 2025-09-03T08:24:14Z

Description

Motivation and Context

How Has This Been Tested?

Screenshots (if appropriate):

Types of changes

Bug fix (non-breaking change which fixes an issue)
New feature (non-breaking change which adds functionality)
Breaking change (fix or feature that would cause existing functionality to change)
Documentation Update (if none of the other choices apply)

🚨 Checklist:

Further comments

🙏 Thank you!

Thank you for contributing to this project. We appreciate your time and effort. 🎉

gemini-code-assist

Summary of Changes

Hello @soumyaa13, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request significantly expands the platform's API capabilities by introducing new functionalities for service activation, Aadhaar-based financial transactions, and financial settlements. These additions aim to enhance the services available to agents and merchants, streamlining processes for BBPS, fund transfers, and AEPS operations, and enabling new redirection features.

Highlights

BBPS Service Activation: Added a new API to activate BBPS (Bharat BillPay System) service for users (agents/merchants/retailers).
Fund Transfer Service Activation: Introduced a new API to activate Fund Transfer service for agents and updated existing documentation to reference this new activation method.
AEPS (Aadhaar Enabled Payment System) - Fingpay APIs: Integrated a comprehensive suite of AEPS APIs, including functionalities for eKYC (OTP request, OTP verification, biometric authentication, daily KYC), transaction processing (cash withdrawal, balance enquiry, mini statement), and settlement management (adding accounts, listing accounts, initiating settlements).
CreditLinks Redirection URL: Added a new API to generate CreditLinks redirection URLs for users.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point in your pull request via creating an issue comment (i.e. comment on the pull request page) using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands.

Feature	Command	Description
Code Review	`/gemini review`	Performs a code review for the current pull request in its current state.
Pull Request Summary	`/gemini summary`	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in issue comments and review comments.
Help	`/gemini help`	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

gemini-code-assist

Code Review

This pull request introduces documentation for several new v3 APIs, including BBPS activation, Fund Transfer activation, and a comprehensive set of APIs for AEPS (Fingpay). The changes are extensive and well-detailed. My review focuses on improving the consistency, clarity, and correctness of the new documentation. I've identified several minor typos, formatting issues, and inconsistencies in parameter descriptions and sample responses. I've also noted a more significant issue with an inconsistent URL structure. Addressing these points will enhance the developer experience and reduce potential confusion when integrating with these new APIs.

markdown/README.md

gemini-code-assist · 2025-09-03T08:26:37Z

markdown/README.md

+- **URL Endpoint:** /admin/network/agent/{user_code}/fund-transfer/activate
+- **Request Structure:**
+  - Body Parameters:
+    - initiator_id (string / required) - Your registered mobile number (See Platform Credentials for UAT)  


This line has trailing whitespace, which might be unintentional. In Markdown, two trailing spaces can create a line break (<br>), which could affect rendering. It's best to remove it for clean and predictable markup.

Suggested change

- initiator_id (string / required) - Your registered mobile number (See Platform Credentials for UAT)

- initiator_id (string / required) - Your registered mobile number (See Platform Credentials for UAT)

gemini-code-assist · 2025-09-03T08:26:37Z

markdown/README.md

+- **URL Endpoint:** /user/collection/aeps-fingpay/kyc/otp
+- **Request Structure:**
+  - **Body Parameters:**
+    - **initiator_id** (string / required) - Registered mobile number of the agent.


The description for initiator_id is inconsistent with other parts of the documentation. Here it is 'Registered mobile number of the agent.', but other sections use the more helpful 'Your registered mobile number (See Platform Credentials for UAT)'. Using the latter consistently would improve clarity for developers. This applies to other new AEPS APIs in this file as well.

Suggested change

- **initiator_id** (string / required) - Registered mobile number of the agent.

- **initiator_id** (string / required) - Your registered mobile number (See Platform Credentials for UAT).

markdown/README.md

manustays

LAST LINE REVIEWED: 4069

REST OF THE REVIEW PENDING (After Yahswant's review)

manustays · 2025-09-15T07:36:46Z

markdown/README.md

@@ -266,18 +266,18 @@ Get the status of a transaction using Eko TID or client_ref_id
 - **Method:** GET
 - **URL Endpoint:** /tools/reference/transaction/{transaction-reference}


Remove {transaction-reference} from PATH

manustays · 2025-09-15T07:40:21Z

markdown/README.md

 #### Description
 **Examples:**
-To check the status of a transaction using TID 12345, use following endpoint: `/tools/reference/transaction/12345
+To check the status of a transaction using TID 12345, use request format: `/tools/reference/transaction`


To check the status of a transaction using TID 12345, pass tid=12345 in the request body.

In case you have not received Eko's TID (say, due to network timeout), you can enquire about the status of a transaction using your own unique reference number (say, 567890) by passing it in the client_ref_id parameter in the request body.

manustays · 2025-09-15T07:42:29Z

markdown/README.md

@@ -500,12 +500,28 @@ Get the current balance (E-value) of your or your user's wallet.
 - **Method:** GET
 - **URL Endpoint:** /user/account/balance


Update URL PATH

manustays · 2025-09-15T07:44:49Z

markdown/README.md

 - **Method:** POST
- **URL Endpoint:** /customer/account
+- **URL Endpoint:** /customer/account/{customer_id}/ppi-digikhata
 - **Request Structure:**


Add path parameter: customer_id

manustays · 2025-09-15T07:49:01Z

markdown/README.md


 ### 3.1 Send Transaction OTP API
+
 The system will generate a One-Time Password (OTP) and deliver it to the sender's registered mobile number as part of a security or verification process.


"Send a One-Time Password (OTP) to the sender's registered mobile number, which is required by the bank for verification."

manustays · 2025-09-15T07:50:44Z

markdown/README.md

-### 3.2 Initiate Transaction API
+### 3.2 Initiate PPI-DigiKhata Transaction API
+
 Initiate a PPI transaction to a bank account.


Initiate a PPI fund transfer transaction to a bank account.

manustays · 2025-09-15T07:59:17Z

markdown/README.md

+
+#### Details
+- **Method:** PUT
+- **URL Endpoint:** /admin/network/agent/{user_code}/qr/activate


Add PATH Parameter section below for user_code

manustays · 2025-09-15T09:59:08Z

markdown/README.md

+### 1.7. Bank Account Verification (Sync) API
+Verify a bank account number by transferring ₹1 to retrieve the name of the account holder.
+
+> **Note:** Not applicable for all banks. Only applicable for banks for whom account verification feature is available. This can be checked by using the Get Bank Details API.


> **Note:** The verification feature is not available for all banks. Use the _Get Bank Details API_ to check whether account verification is available for a particular bank.

manustays · 2025-09-15T10:03:51Z

markdown/README.md

+
+#### Details
+- **Method:** POST
+- **URL Endpoint:** /tools/kyc/bank-account/sync


This URL has to change. Consult with Kumar Abhishek before proceeding.

soumyaa13 added 4 commits September 2, 2025 19:08

new v3 apis

730f298

new api addition

3c5e1d9

gemini code review changes

b927fbb

Merge branch 'dev' into newV3_apis

f1ed5ec

gemini-code-assist bot reviewed Sep 3, 2025

View reviewed changes

soumyaa13 added 2 commits September 8, 2025 11:31

changes

70c9687

v3 changes

251f304

manustays requested changes Sep 15, 2025

View reviewed changes

	- initiator_id (string / required) - Your registered mobile number (See Platform Credentials for UAT)
	- initiator_id (string / required) - Your registered mobile number (See Platform Credentials for UAT)

	- initiator_id (string / required) - Registered mobile number of the agent.
	- initiator_id (string / required) - Your registered mobile number (See Platform Credentials for UAT).

		@@ -266,18 +266,18 @@ Get the status of a transaction using Eko TID or client_ref_id
		- Method: GET
		- URL Endpoint: /tools/reference/transaction/{transaction-reference}

		@@ -500,12 +500,28 @@ Get the current balance (E-value) of your or your user's wallet.
		- Method: GET
		- URL Endpoint: /user/account/balance


		### 3.1 Send Transaction OTP API

		The system will generate a One-Time Password (OTP) and deliver it to the sender's registered mobile number as part of a security or verification process.

New v3 apis #47

Are you sure you want to change the base?

New v3 apis #47

Uh oh!

Conversation

soumyaa13 commented Sep 3, 2025

Description

Motivation and Context

How Has This Been Tested?

Screenshots (if appropriate):

Types of changes

🚨 Checklist:

Further comments

🙏 Thank you!

Uh oh!

gemini-code-assist bot left a comment

Choose a reason for hiding this comment

Summary of Changes

Highlights

Footnotes

Uh oh!

gemini-code-assist bot left a comment

Choose a reason for hiding this comment

Code Review

Uh oh!

Uh oh!

gemini-code-assist bot Sep 3, 2025

Choose a reason for hiding this comment

Uh oh!

gemini-code-assist bot Sep 3, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

manustays left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants