1. Outbound Webhooks
marketplace-doc
  • Data Ingestion
  • Errors
  • Introduction
  • Loan API & Deduction Lifecycle
  • Getting Started
  • OAuth
  • Webhooks
  • Embedded Journey
  • OpenSylo Marketplace Integration API
    • OAuth 2.0
      • Start OAuth authorization
      • Exchange authorization code or refresh token
      • Revoke a token
      • Discover OAuth capabilities
    • Data Ingestion
      • Submit single merchant data
      • Submit bulk merchant data
      • Poll batch processing status
      • Get merchant credit score
      • Data ingestion health check
    • Sales & Events
      • Submit a sales event
      • Submit a repayment event
      • Submit an account flag
    • Loan API
      • Get active loans for a merchant
      • Get loan status
      • Validate deduction amounts
      • Bulk loan status
    • Inbound Webhooks
      • Repayment events
      • Settlement events
    • Outbound Webhooks
      • loan.approved
        POST
      • loan.disbursed
        POST
      • loan.repayment_updated
        POST
      • loan.nearly_complete
        POST
      • loan.completed
        POST
      • loan.defaulted
        POST
      • merchant.created
        POST
      • kyc.submitted
        POST
      • kyc.approved
        POST
      • kyc.rejected
        POST
      • funding_request.created
        POST
      • funding_request.fulfilled
        POST
      • funding_request.rejected
        POST
    • Embedded Journey (Marketplace API)
      • Create (or fetch) a merchant
      • Get merchant status (KYC, credit score, funding requests)
      • Update business KYC information
      • Add directors (bulk)
      • Attach a KYC document
      • Submit KYC for review
      • Submit sales data for credit scoring
      • Create a funding request
      • Mint an embed token for the hosted journey
  • OpenSylo Marketplace API
    • OAuth 2.0
      • Start OAuth authorization
      • Exchange code or refresh token
      • Revoke a token
      • OAuth discovery / client metadata
    • Data Ingestion
      • Submit single merchant data
      • Submit bulk merchant data
      • Get merchant credit score
      • Integration health check
    • Loan API
      • Get active loans for a merchant
      • Get loan status
      • Validate deduction amounts
      • Bulk loan status check
    • Inbound Webhooks
      • Send repayment webhook
      • Send settlement webhook
  1. Outbound Webhooks

loan.defaulted

POST
/webhooks/outbound/loan.defaulted
Documentation only -- this event is sent by OpenSylo to your webhook URL.
Fired when a loan is marked as defaulted due to non-payment. Includes
outstanding amount, overdue days, and collection instructions. Continue
or increase deductions as instructed.

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK
Your server should return 200 to acknowledge receipt.
This response does not have a body.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.opensylo.com/webhooks/outbound/loan.defaulted' \
--header 'X-OpenSylo-Signature: sha256=f1e2d3c4b5a6f7e8d9c0b1a2f3e4d5c6b7a8f9e0d1c2b3a4f5e6d7c8b9a0f1e2' \
--header 'X-OpenSylo-Timestamp: 1712495400' \
--header 'X-OpenSylo-Event-Id: evt_oa_20260407_001' \
--header 'Content-Type: application/json' \
--data '{
    "event": "loan.defaulted",
    "event_id": "evt_odf_20260407_006",
    "timestamp": "2026-04-07T20:00:00.000Z",
    "loan": {
        "id": "loan_f1e2d3c4-b5a6-7890-1234-567890abcdef",
        "reference": "OSL-2026-00142",
        "status": "defaulted"
    },
    "merchant": {
        "opensylo_id": "mch_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "marketplace_id": "PLT_MERCH_001"
    },
    "default_details": {
        "outstanding_amount": 862500,
        "days_overdue": 45,
        "last_payment_date": "2026-02-20T12:00:00.000Z"
    },
    "collection_instructions": {
        "continue_deductions": true,
        "priority": "high",
        "deduction_percentage": 15
    }
}'
Modified at 2026-06-10 14:59:29
Previous
loan.completed
Next
merchant.created
Built with