post
https://api.aeronpay.in/api/serviceapi-prod/api/education-fees/payments
Create an education fee payment through IMPS with settlement details, beneficiary information, and optional student-fee data.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Create an education fee payment by sending the payer, beneficiary, settlement, and optional student-fee details to the IMPS payout endpoint.
Prerequisites
- Get your
client-idandclient-secretfrom AeronPay. - Configure your HTTP client to send JSON requests with
content-Type: application/json. - Confirm the beneficiary bank account number, IFSC code, name, email, phone, and address before creating the payment.
- Generate a unique
client_referenceIdfor each payment so you can reconcile its status later.
Required headers
| Header | Type | Required | Description |
|---|---|---|---|
client-id | string | Yes | Unique client ID provided by AeronPay. |
client-secret | string | Yes | Unique client secret provided by AeronPay. |
content-Type | string | Yes | Set to application/json. |
Request body
| Parameter | Type | Required | Description |
|---|---|---|---|
bankProfileId | string | Yes | Connected bank profile or virtual account ID. Use 1 for the default profile. |
bankid | string | Yes | Bank identifier. |
accountNumber | string | Yes | Registered AeronPay account number. |
amount | string | Yes | Payment amount as a decimal string. Example: 10.00. |
client_referenceId | string | Yes | Unique payment reference generated by your system. |
transferMode | string | Yes | Transfer mode. Set to imps. |
settlementCycle | string | Yes | Settlement cycle for the payment. Example: T+1. |
remarks | string | Yes | Payment remarks. |
latitude | string | Yes | Latitude from which you initiate the payment. |
longitude | string | Yes | Longitude from which you initiate the payment. |
beneDetails | object | Yes | Beneficiary details. |
educationDetails | object | No | Student and fee details for the education payment. |
beneDetails parameters
beneDetails parameters| Parameter | Type | Required | Description |
|---|---|---|---|
bankAccount | string | Yes | Beneficiary bank account number. |
ifsc | string | Yes | Beneficiary bank IFSC code. |
name | string | Yes | Beneficiary name. |
email | string | Yes | Beneficiary email address. |
phone | string | Yes | Beneficiary phone number. |
address1 | string | Yes | Beneficiary address. |
Optional: educationDetails parameters
educationDetails parametersInclude educationDetails only when you need to associate the payment with a student fee record. All parameters in this object are optional.
| Parameter | Type | Required | Description |
|---|---|---|---|
institutionName | string | No | Name of the educational institution. |
studentName | string | No | Student name. |
studentId | string | No | Student identifier. |
feeReference | string | No | Fee invoice or reference identifier. |
academicYear | string | No | Academic year for the fee. |
feeType | string | No | Type of fee. Example: tuition. |
Sample request body
{
"bankProfileId": "1",
"bankid": "1",
"accountNumber": "9460827467",
"amount": "10.00",
"client_referenceId": "EDU-202edd60926-0001",
"transferMode": "imps",
"settlementCycle": "T+1",
"remarks": "Tuition fee",
"latitude": "20.1236",
"longitude": "78.1228",
"beneDetails": {
"bankAccount": "4377264824264",
"ifsc": "ICIC0000101",
"name": "Example College",
"email": "[email protected]",
"phone": "9999988888",
"address1": "Mumbai"
},
"educationDetails": {
"institutionName": "Example College",
"studentName": "Test Student",
"studentId": "ST-001",
"feeReference": "INV-2026-001",
"academicYear": "2026-2027",
"feeType": "tuition"
}
}Response
A 201 response with status set to PENDING means AeronPay accepted the education fee payment and settlement has not completed. Store the transactionId and client_referenceId, and do not mark the payment as successful until you receive a final settlement status.
{
"status": "PENDING",
"statusCode": "201",
"message": "Education fee payment accepted; settlement is pending.",
"data": {
"transactionId": "ARNPY2609261347224173",
"client_referenceId": "EDU-202edd60926-0001",
"amount": "10.00",
"charge": "0.00",
"totalDebit": "10.00",
"currency": "INR",
"transferMode": "imps",
"settlementCycle": "T+1",
"acceptedAt": "2026-09-26T08:17:22+00:00",
"settlementEligibleAt": "2026-09-27T08:17:22+00:00",
"processorReference": null,
"utr": null,
"failureCode": null,
"replayed": false
}
}Troubleshooting
- Verify that every required request-body parameter is present and that
beneDetailscontains all required beneficiary fields. - Treat a
PENDINGpayment as unsettled. Do not credit, close, or mark the payment as successful until you receive its final settlement status. - Omit
educationDetailswhen you do not need to associate the payment with student or fee information.