Supporting evidence
Lender integrations
The complete artifacts and detailed records behind the account. Current public references, original work and proposed designs retain their labels.
Detailed material
The challenge
Each lender brought different eligibility rules, status language and commercial commitments. A shared customer journey still needed to explain those differences after handoff. The question was what the platform could normalize without losing the context needed to act on a case.
Shared structure without erasing partner meaning
I identified eligibility, KYC handoff, application status and payout information as recurring concerns across lender connections. I worked with engineering on a common structure and with lender teams on policy, responsibilities and service commitments. That was an alternative to making each new partner another unrelated borrower journey.
Engineering requirements and ongoing operating ownership
I worked directly with engineering and partners on the modular lending stack, KYC responsibility, service levels and commercials. Rejection feedback could inform routing and product priorities. I also recruited across product, sales and operations, helping build the cross-functional capability for continuing partner follow-through.
Daily MIS joined lender-wise funnel performance, service-level tracking, payout reconciliation and disputes. The operating question continued after a request was accepted: which case was waiting, which partner commitment needed attention, and which commercial record remained unresolved? Those queues belonged in partner reviews as well as in the interface.
Impact and its limits
The work joined common eligibility, KYC, status and payout requirements to daily MIS and partner follow-through. The detailed API, metadata and security models in the supporting material are reference designs; the case does not establish their production deployment or a measured integration-performance gain.
Make the boundary inspectable without overstating delivery
The case does not publish a shareable live contract, actual anonymized status mapping or dispute-resolution episode. The reference example makes the intended boundary inspectable while keeping that evidence gap explicit. No onboarding-speed, reliability or integration-performance gain is claimed.
An illustrative status mapping
The cost of a common status is that it can hide information. A platform stage has to remain understandable to the customer while retaining the lender’s reason, reference and timing for operations. The comparison below is illustrative: “received for review” is a successful handoff, not approval; “needs information” should identify the next evidence task without making the borrower start again.
These examples explain the abstraction decision, not a published production schema. The delivered account supports common integration requirements and partner operations; the later metadata, authentication and API payload models are reference designs. They are not evidence that particular credential methods, retries or callback controls were deployed.
Scroll across to see every column.
| Partner result | Common meaning | Context retained | Next action |
|---|---|---|---|
| Received for review | Lender accepted the handoff; decision pending | Original partner status, case reference and event time | Follow the agreed review queue; do not show approval |
| Needs information | Case requires more evidence | Partner reason, missing evidence and current case reference | Request the specified information and preserve the existing case |
Authored example. These labels and fields are not an actual lender contract or an observed incident.
Application state is different from the commercial record
A successful API handoff does not mean a loan was approved, and disbursement does not prove marketplace revenue was earned or collected. That distinction is the practical reason for an operating owner around the shared contract. Reuse should reduce inconsistent handling without making it harder to explain what the lender actually said.
Reference contract: common meaning and retained provenance
Authored reference contract, dated 14 October 2026. The shared meaning should retain the lender detail operations needs: policy version, original status/reason, case reference and event time. The field inventory below illustrates that design; it is not a published implementation schema.
Normalization should distinguish missing evidence, a failed pre-check, a lender decision and a commercial qualifying event. Replacing them with a single successful flag would simplify the interface while making disagreements harder to investigate.
Scroll across to see every column.
| Contract area | Illustrative information | Why it matters |
|---|---|---|
| Partner metadata | Partner/product identifier, permitted environment, agreed endpoints and supported schema version. | Make capability, ownership and sandbox-versus-production status explicit before routing a case. |
| Case identity | Opaque case reference, correlation ID and submission idempotency key. | Join logs and partner responses; avoid treating a retry as a new borrower application. |
| Authorised information | Consent reference, purpose, lender destination and the permitted evidence references. | A login or integration credential alone does not establish permission to share a borrower’s information. |
| Eligibility and evidence | Versioned applicant inputs, document completeness and reason-coded pre-check result. | Separate a missing input, a failed policy condition and a lender’s final credit decision. |
| Status mapping | Original lender status/reason, normalised stage, event timestamp and lender case reference. | A receiving partner’s acceptance of a file is different from a sanction or disbursement. |
| Payout and reconciliation | Commercial agreement version, qualifying event, statement reference and adjustment/dispute status. | A successful API response is not proof of earned or collected marketplace revenue. |
No actual endpoint URL, bank secret, borrower record or lender-specific contract is published. This is a product specification example.
Reference handshake — proposed controls
Proposed reference boundary: configure an approved partner, authorize the case, submit with a stable identity, interpret the partner response and reconcile the outcome. Authentication, retry and callback behaviour require partner-specific implementation evidence.
For an OAuth-based design, RFC 9700 provides reference questions about token audience, expiry, narrow scopes and client authentication. Mutual TLS and signed client assertions are options to evaluate against the lender contract, not descriptions of the delivered stack. Case authorization remains distinct from connection authentication.
Scroll across to see every column.
| Step | Acceptance boundary | Failure response to design |
|---|---|---|
| Agree and configure | Approved partner, product, environment, API version, service levels and ownership are recorded. | Reject an unknown partner or unsupported version; do not silently select a different product. |
| Authenticate | Establish the caller identity and validate credentials for the intended API. | Deny invalid, expired or misdirected credentials without returning case data. |
| Authorise | Check the caller’s role, lender/case scope and applicable consent before access. | Deny another partner’s case or an out-of-purpose request even when the caller is authenticated. |
| Validate and route | Validate required inputs and documents; use a stable submission key and configured adapter. | Return a specific missing-field or policy error; do not convert an incomplete file into an approval. |
| Receive status | Match the partner reference and preserve original status, reason and timestamp. | Reconcile stale, duplicate or out-of-order updates; verify any callback before accepting it. |
| Reconcile and audit | Join submission, lender response, service queue and commercial record by case reference. | Route an unresolved mismatch to an accountable owner; never infer money received from an API acknowledgement. |
Callback signatures, token format, retry limits, credential rotation and storage controls require partner-specific evidence before they can be presented as implemented.
Illustrative result and payload detail
Illustrative results distinguish an accepted handoff from approval and a missing-evidence request from an abandoned case. All endpoint names and opaque values in the technical table are invented specification examples; no borrower record or live endpoint is published.
Scroll across to see every column.
| Part | Example shape | Meaning |
|---|---|---|
| Request | POST /reference/v1/cases/submit · caseRef: case-example · partnerProductRef: product-example · consentRef: consent-example · policyVersion: version-example | The service must resolve authorised evidence and validate the target partner contract; this path is not an actual endpoint. |
| Request metadata | correlationId: request-example · idempotencyKey: submission-example · schemaVersion: schema-example | Trace one request across the adapter and safely identify repeated submissions. |
| Accepted response | stage: received_for_review · partnerCaseRef: partner-case-example · decisionStatus: pending | Received for review describes a handoff; it cannot be displayed as sanctioned or disbursed. |
| Incomplete response | stage: needs_information · missingEvidence: [required-document-reference] · retryable: true | Return an actionable reason and retain the current case instead of asking the borrower to start again. |
| Operational record | callerRef · permittedCaseRef · contractVersion · statusTransition · eventTime | An authored minimal audit model; exclude credentials and avoid raw personal data in routine logs. |
Example values and payload names are illustrative. No production schema, authentication handshake or API-test result is supplied.
Documented operating concerns and proposed checks
Documented operating responsibilities include daily MIS, service-level queues, partner reporting, disputes and payout reconciliation. Status disagreement and payout disputes illustrate why the service needs an accountable owner after handoff.
The table is a proposed review map for access, failures, retries and version changes. OWASP references supply security-review topics; they do not establish executed penetration testing, reliability benchmarks or implemented controls.
Scroll across to see every column.
| Risk or queue | Proposed behaviour | Evidence to request |
|---|---|---|
| Unavailable partner | Bound retries and show the case as pending; distinguish dependency failure from ineligibility. | Timeout fixtures, retry/dead-letter behaviour and an operations owner. |
| Status disagreement | Preserve partner truth, map it transparently and flag conflicting or late events. | Contract examples and reordered/duplicate callback checks. |
| Data exposure | Check case ownership on every access; minimise response fields and redact routine logs. | Role/partner access tests, retention policy and reviewed log examples. |
| Service-level breach | Measure the agreed stage clock and surface cases waiting for the lender or operations. | Defined start/stop events, pending-age dashboard and escalation policy. |
| Payout dispute | Join the qualifying case with the agreement, statement and disputed adjustment. | Reconciled statement examples and resolution history; rates are not supplied. |
| New integration version | Record active contract versions and test old cases before changing an adapter. | API inventory, schema compatibility fixtures and rollback plan. |
Documented recurring concerns are distinguished from these proposed control implementations; no onboarding-speed or reliability benchmark is invented.
Where the lender agreement and customer protection meet
Dated legal-reference context: the reviewed July 2026 commercial-bank text discusses lender responsibility, comparable multi-lender offers, lender-paid LSP fees, consent and data retention. The October page title was checked separately. These references do not establish this business’s RE–LSP classification, lender-class applicability, implemented controls or a completed compliance review.
Notes and sources
- Evidence: my career and operating account of common integration requirements, engineering/partner work, daily MIS and commercial follow-through. The status mapping, API payload, handshake and control map are authored reference examples, not production documentation.
- The wider lending panel is reported as 20+ banks/NBFCs; that is not a verified count of integrations using one contract. Eight EduLoans configurations describe a separate rule model. Recruiting contribution is documented; direct-report count, team size and integration-time gains are not established.
- Official API/security/legal references support review questions only. No live endpoint, lender-specific security scheme, execution trace, security assessment or compliance certification is claimed.
Career account and authored contract model · 14 October 2026 · Documented remit; authored operating explanation; financial inputs not supplied
Authored API reference and IETF security guidance · 14 October 2026 · RFC 9700, January 2025; deployment choices unverified
Authored product operating framework · 14 October 2026 · Reference design to explain documented responsibilities; not an observed implementation or measured result
Documented operations and authored security review · 14 October 2026 · OWASP API Security Top 10, 2023; proposed tests, not an executed security assessment
Official RBI commercial-bank reference · 14 October 2026 · Full July 15, 2026 text reviewed; current page title checked October 14, 2026; lender-specific applicability not established