Submit an account flag

POST

https://api.opensylo.com/api/marketplace/account-flags

Reports an account flag or risk signal for a merchant. Flags affect the
merchant's credit score and lending eligibility. Idempotent when
idempotency_key is provided.

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

Account flag created.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.opensylo.com/api/marketplace/account-flags' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "platform_merchant_id": "PLT_MERCH_001",
    "flag_type": "ACCOUNT_SUSPENDED",
    "flag_severity": "INFO",
    "description": "Merchant refund rate exceeded 10% threshold for 3 consecutive months.",
    "flagged_at": "2026-04-07T12:00:00.000Z",
    "evidence": {
        "refund_rate_3m": 12.5,
        "refund_count": 45,
        "total_orders": 360
    },
    "idempotency_key": "idem_flag_20260407_001",
    "metadata": {
        "property1": "string",
        "property2": "string"
    }
}'

Response Example

201 - Example 1

{
    "success": true,
    "flag_id": "flg_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "ingested_at": "2026-04-07T14:28:00.000Z"
}

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

Submit a repayment event

Get active loans for a merchant