Overview
This is a Webhook-integrated trigger that activates as soon as a candidate pays the configured Token fees. The system pushes all payment-approved entries in real time from Meritto to the configured Third-Party API Endpoint (set up in Webhook).
Plan & Permissions
Plan/Package Requirements:
Available as an Add-on
Permissions Required:
- To configure webhooks, Configure ERP permission should be configured and grouped under Post Application Manager.
- For Manual Push
-
- Bulk Data Push Through Webhook/ERP - Allows user to Bulk Push manually. (Different for LM / AM / OM)
- Allow Data Flow to ERP - Allows a user to single-push manually. (Different for LM / AM / OM)
-
Core Functionalities
Real-Time Webhook Trigger
All payment-approved entries across supported payment modes are pushed in real time via webhook.
Supported Real-Time Payment Modes: More like scenario than just modes.
- Online Payments:
When the candidate pays the token fees through online mode (including payments made using discount coupons), the data is pushed in real time upon successful transaction. - Offline Payment (Approved by Backend):
For payments made via offline modes like cash or demand draft (DD), the data is pushed in real time once the backend user approves the payment. - Instant Payment Notification (IPN):
If the system receives an IPN confirmation from the payment gateway, the payment data is pushed instantly. - Status API / Refresh Payment Option:
When payment approval is triggered using the "Refresh Payment" option on the purchase summary page, the data is pushed in real time. - Partial and Full Payments:
Whether the candidate pays partially or in full, each payment entry is pushed in real time as soon as it is confirmed. - Loan Payments via Collexo:
If the candidate applies for a loan through Collexo and the disbursed amount is marked as approved in Meritto, the data is pushed in real time. - Collexo Token Fee Configuration:
When Collexo token fees are configured and the payment is completed and approved, the system pushes the data in real time.
System Behavior:
- Every successful payment-approved entry is pushed immediately in real time.
- For partial payments, each approved part is pushed.
Fallback Mechanism
To ensure reliability, two Fallback Mechanisms support the real-time push logic:
A. Fallback Mechanism (Runs Every 30 Minutes):
- If there is any payment approved case, which does not get pushed in real time due to any meritto system error , the Fallback Mechanism picks the data in intervals of 30 minutes, and pushes the data to the configured endpoint.
B. Fallback Mechanism (Runs Once Daily at Night):
- All the cases which are failed due to 3rd party API errors are retired by the Fallback Mechanism once in night.
System Behavior:
- All scenarios are real-time first.
- Fallback Mechanism ensures no entries are missed due to real-time failures or system delays.
Manual Push (Single/Bulk Push)
Users can manually trigger a webhook push for one or more candidates from Application Manager.
System Behavior:
The Selected Token Fees in the Manual Push Pop-up will be pushed.
Now you can select the Token fees against which you want to push the data via manual push, this dropdown will show all the configured Token Fees in webhook configuration. In case of partial payment for the selected token fees only the latest entry will be pushed.
- In case of Partial Payments, only the latest successful token fee payment entry per candidate is pushed.
⚠️ Known Case – Bundle Fees Behavior
paid_ammount_token
will reflect the total bundle fee paid and not just the token fee amount. This is expected behavior due to the way payment is consolidated under bundle logic.Benefits of the Functionalities
- Accurate Data Sync: Consistently delivers real-time payment data to integrated platforms.
- Fallback Redundancy: Cron-based fallback ensures missed entries are eventually pushed.
- Operational flexibility: Manual push options give teams better control in exceptional situations.
- Payment-Mode Flexibility: Handles complex scenarios like coupons, free payments, and loan-based entries.
- Webhook Logic Flexibility: Uses OR logic to reduce the need for multiple webhook setups across token fees.
Conclusion
The Token Fees Webhook Trigger is a reliable and comprehensive ERP integration for pushing token fee payment data in real time . With robust fallback mechanisms via cron jobs and intelligent manual push handling, it ensures no data loss, minimal duplication, and maximum alignment with business workflows.
Comments
0 comments
Please sign in to leave a comment.