Submit a repayment event

POST

https://api.opensylo.com/api/marketplace/repayment-events

Records a repayment collection event (collection, deduction, refund, or reversal).
Used to report repayment activity that occurs within the marketplace's own system.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢201Created

application/json

Repayment event created.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠409

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.opensylo.com/api/marketplace/repayment-events' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "event_id": "evt_repay_20260407_001",
    "platform_merchant_id": "PLT_MERCH_001",
    "event_type": "COLLECTION",
    "collection_date": "2026-04-07",
    "loan_id": "loan_f1e2d3c4-b5a6-7890-1234-567890abcdef",
    "scheduled_amount": 5000,
    "collected_amount": 5000,
    "outstanding_amount": 1375000,
    "currency": "NGN",
    "collection_reference": "COL-20260407-001",
    "payment_reference": "FLW-COL-20260407-001",
    "collection_method": "sales_deduction",
    "failure_reason": "string",
    "idempotency_key": "idem_repay_20260407_001",
    "metadata": {
        "property1": "string",
        "property2": "string"
    }
}'

Response Example

201 - Example 1

{
    "success": true,
    "event_id": "evt_repay_20260407_001",
    "processed_at": "2026-04-07T14:25:00.000Z"
}

Modified at 2026-06-10 14:59:29

Submit a sales event

Submit an account flag