OpenSylo Marketplace API
    OpenSylo Marketplace API
    • Introduction
    • Getting Started
    • OAuth 2.0 Flow
    • Webhook Integration
    • Sandbox Testing
    • Error Reference
    • Marketplace Dashboard
      • Login to the marketplace dashboard
      • View OAuth credentials
      • Regenerate client secret
    • 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
    • Sandbox
      • Sandbox environment info
      • Get sandbox test credentials
      • Get sandbox test merchants
    • Schemas
      • DashboardLoginRequest
      • DashboardLoginResponse
      • CredentialsResponse
      • RegenerateSecretResponse
      • TokenRequest
      • TokenResponse
      • RevokeRequest
      • ClientMetadataResponse
      • MerchantIdentity
      • SalesPerformance
      • RevenueConsistency
      • FulfillmentMetrics
      • PayoutCashFlow
      • PlatformDependency
      • HistoricalCredit
      • BehavioralRisk
      • MerchantDataRequest
      • ScoreBreakdown
      • CreditScore
      • MerchantDataResponse
      • BulkMerchantDataRequest
      • BulkMerchantDataResponse
      • CreditScoreResponse
      • HealthResponse
      • ActiveLoansResponse
      • LoanStatusResponse
      • ValidateDeductionsRequest
      • ValidateDeductionsResponse
      • BulkLoanStatusRequest
      • BulkLoanStatusResponse
      • RepaymentWebhookRequest
      • SettlementWebhookRequest
      • WebhookAckResponse
      • SandboxInfoResponse
      • SandboxCredentialsResponse
      • SandboxMerchantsResponse
      • OAuthError
      • ApiError

    MerchantDataRequest

    {
        "merchantIdentity": {
            "merchantId": "your_internal_merchant_id",
            "businessName": "Yakoyo Foods Ltd",
            "businessType": "REGISTERED_BUSINESS",
            "marketplaceOnboardingDate": "2023-06-15T00:00:00.000Z",
            "verificationStatus": true,
            "location": "Lagos, Nigeria",
            "country": "Nigeria",
            "category": "food_beverages"
        },
        "salesPerformance": {
            "gmv30Days": 2500000,
            "gmv90Days": 8200000,
            "gmv180Days": 18500000,
            "avgMonthlySales": 3100000,
            "orderCount": 456,
            "avgOrderValue": 6800,
            "salesGrowthRate": 15.5
        },
        "revenueConsistency": {
            "monthlySalesVariance": 12.5,
            "zeroSalesMonths": 0,
            "longestSalesStreak": 18,
            "revenueConcentration": 35.2
        },
        "fulfillmentMetrics": {
            "fulfillmentRate": 97.8,
            "cancellationRate": 2.1,
            "refundRate": 1.5,
            "refundAmount": 45000,
            "disputeRate": 0.8,
            "lateDeliveryRate": 3.2
        },
        "payoutCashFlow": {
            "payoutFrequency": "DAILY",
            "avgPayoutValue": 775000,
            "failedPayouts": 0,
            "walletBalanceUsage": 125000,
            "settlementDelays": 0
        },
        "platformDependency": {
            "topProductGmvPercentage": 28.5,
            "topCustomerPercentage": 12.3
        },
        "historicalCredit": {
            "previousAdvances": 2,
            "repaymentRate": 100,
            "daysPastDue": 0,
            "hasDefaults": false,
            "earlyRepayments": 1
        },
        "behavioralRisk": {
            "accountSuspensions": 0,
            "policyViolationsSeverity": null,
            "hasFraudFlags": false,
            "hasSuddenGmvSpikes": false,
            "hasLinkedAccounts": false
        },
        "marketplaceId": "your_marketplace_id",
        "dataTimestamp": "2026-01-29T08:00:00.000Z",
        "correlationId": "corr_abc123"
    }
    Built with