Payment events now require due_date as a date-only field, separating scheduled due dates from optional receipt timestamps.
Payment Events
- Added due_date as a required field using YYYY-MM-DD format.
- Kept payment_date as an optional actual receipt timestamp for paid payments.
- Removed write_off and insurance from active examples, validator UI, and FAQ navigation.
- Updated payment examples, payload reference, FAQ documentation, and validator logic.
Migration Notes
- Send due_date on every payment event using date-only format, for example "2024-11-20".
- Continue using payment_date for actual payment receipt timestamp when status is paid.
- Use disbursement updates with change_date and change_reason for extension, rebate, and write-off derived rows.
Backend alignment release: synchronous ingest processing, four active top-level categories, disbursement_id child references, and legacy loan/purchase migration into disbursements.
Ingest Categories
- Active /ingest categories are client, disbursement, operation, and payment.
- Added operation documentation for revenue/cost data and optional asset fields.
- Deprecated categories are documented as no longer accepted as top-level ingest categories.
References And Processing
- payment and operation require disbursement_id.
- Deprecated entity_type and entity_id fields are tolerated but ignored by new processing.
- Worker stores and processes events synchronously in request path.
Migration Notes
- Keep loan and purchase semantics inside disbursement.kind.
- Send operation/asset source data through operation.
- Update child payloads from entity_type/entity_id to disbursement_id.
Major restructuring release. loan and purchase categories are replaced by disbursement with kind, payment gains status/payment_fee/installment_number, and schedule is modeled as expected payments.
Disbursement Category
- Unified entity replaces loan and purchase.
- kind: "loan" requires disbursement_date and maturity_date.
- kind: "purchase" requires operation_date, payment_date, estimated_delivery_date, goods_description, and goods_status.
Payment Category
- Added required status: expected, paid, or canceled.
- Added optional payment_fee and installment_number.
- Use expected payment series to model schedules.
Migration Notes
- Replace loan payloads with disbursement + kind: "loan".
- Replace purchase payloads with disbursement + kind: "purchase".
- Replace schedule payloads with payment events using status: "expected".
Documentation-only update clarifying the installments array structure for Schedule events.
Schedule Documentation
- Documented required installments keys and optional principal_amount.
- Added detailed installments JSON example.
Insurance events gained required percentage field for coverage amount between 0 and 1.
Insurance Events
- Added percentage as required field.
- Default value is 1 for full coverage.
Migration Notes
- When creating or updating Insurance events, include percentage.
- Use 1 for full coverage or a decimal such as 0.75 for partial coverage.
Aligned required field validations, examples, FAQs, and validator behavior with official required fields specification.
Required Fields Updates
- Added step as required for Loan, Restructure, and Client events.
- Corrected required/optional fields across Purchase, Credit Decision, Asset, Goods Status, and Client events.
- Updated validators with corrected required fields.
Migration Notes
- Include newly required fields when sending legacy categories from this version.
Initial API specification with event ingestion, idempotency, API key authentication, rate limiting, JSON validator, and FAQ documentation.
Features
- Event ingestion with idempotency guarantees.
- API key authentication.
- Support for initial event categories and JSON payload validator.