1. Inbound 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
      • loan.disbursed
      • loan.repayment_updated
      • loan.nearly_complete
      • loan.completed
      • loan.defaulted
      • merchant.created
      • kyc.submitted
      • kyc.approved
      • kyc.rejected
      • funding_request.created
      • funding_request.fulfilled
      • funding_request.rejected
    • 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
        POST
      • Send settlement webhook
        POST
  1. Inbound Webhooks

Send repayment webhook

POST
/api/v1/webhooks/marketplace/repayment
Send a repayment event (deducted, failed, reversed) from your marketplace to OpenSylo. Requires HMAC-SHA256 signature authentication via headers. Timestamp must be within 5 minutes of server time.

Request

Authorization
API Key
Add parameter in header
X-Marketplace-Signature
Example:
X-Marketplace-Signature: ********************
or
Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK
application/json
Webhook received
Bodyapplication/json

🟠401Unauthorized
🟠409
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/api/v1/webhooks/marketplace/repayment' \
--header 'X-Marketplace-Timestamp: 1706529000' \
--header 'X-Marketplace-Id: marketplace_uuid' \
--header 'X-Marketplace-Event-Id: evt_rep_001' \
--header 'X-Marketplace-Signature: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "event": "repayment.deducted",
    "event_id": "evt_rep_001",
    "timestamp": "2026-01-29T10:30:00.000Z",
    "marketplace": {
        "id": "marketplace_uuid",
        "name": "Your Marketplace"
    },
    "merchant": {
        "marketplace_id": "your_internal_merchant_id",
        "opensylo_id": "opensylo_merchant_uuid"
    },
    "loan": {
        "opensylo_id": "loan_uuid",
        "opensylo_reference": "LOAN-2026-001"
    },
    "deduction": {
        "reference": "deduct_ref_001",
        "amount": 5000,
        "currency": "NGN",
        "deducted_at": "2026-01-29T10:30:00.000Z"
    },
    "source_transaction": {
        "id": "order_123",
        "type": "sale",
        "gross_amount": 25000,
        "timestamp": "2026-01-29T10:25:00.000Z"
    },
    "loan_balance": {
        "total_due": 100000,
        "total_paid": 55000,
        "outstanding": 45000
    }
}'
Response Response Example
200 - Success Example
{
    "status": "received",
    "event_id": "evt_rep_001",
    "opensylo_reference": "txn_uuid",
    "received_at": "2026-01-29T10:30:01.000Z"
}
Modified at 2026-04-08 17:24:40
Previous
Bulk loan status check
Next
Send settlement webhook
Built with