Create a funding request

POST

/api/v1/marketplace-api/merchants/{ref}/funding-requests

Creates a funding-request intent. The intent starts PENDING and is
fulfilled automatically (within ~2 minutes) once KYC is APPROVED and
a credit score exists -- emitting funding_request.fulfilled with the
created loan_id, or funding_request.rejected with a
failure_reason if credit policy blocks it.

Merchants can request funding while KYC is still SUBMITTED. Each call
creates a new intent (not idempotent).

Request

Authorization

API Key

Add parameter in header

X-OpenSylo-Secret-Key

Example:

X-OpenSylo-Secret-Key: ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢201Created

application/json

Funding-request intent created.

Bodyapplication/json

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.opensylo.com/api/v1/marketplace-api/merchants/mkt_merchant_8421/funding-requests' \
--header 'X-OpenSylo-Secret-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "amountRequested": 2000000,
    "tenorDays": 90,
    "purpose": "Inventory purchase",
    "financingTimeframeDays": 7
}'

Response Example

201 - Success Example

{
    "id": "f5a4b3c2-d1e0-4f9a-8b7c-6d5e4f3a2b1c",
    "status": "PENDING",
    "amountRequested": 2000000,
    "tenorDays": 90,
    "purpose": "Inventory purchase"
}

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

Submit sales data for credit scoring

Mint an embed token for the hosted journey