Submit a sales event

POST

https://api.opensylo.com/api/marketplace/sales-events

Records a sales event (sale, refund, cancellation, chargeback, or adjustment)
for a merchant. Idempotent when idempotency_key is provided -- duplicate
submissions return the original response.

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

Sales event created.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠409

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.opensylo.com/api/marketplace/sales-events' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "event_id": "evt_sale_20260407_001",
    "platform_merchant_id": "PLT_MERCH_001",
    "event_type": "SALE",
    "event_date": "2026-04-07T14:22:00.000Z",
    "order_id": "ORD-2026-00543",
    "customer_id": "CUST_HASH_abc123",
    "gross_amount": 45000,
    "net_amount": 40500,
    "commission_amount": 4500,
    "tax_amount": 0,
    "delivery_fee": 1500,
    "discount_amount": 0,
    "currency": "NGN",
    "payment_method": "card",
    "payment_reference": "FLW-REF-20260407-543",
    "items": [
        {
            "name": "string",
            "quantity": 0,
            "unit_price": 0,
            "total": 0
        }
    ],
    "idempotency_key": "idem_sale_20260407_001",
    "metadata": {
        "property1": "string",
        "property2": "string"
    }
}'

Response Example

201 - Example 1

{
    "success": true,
    "event_id": "evt_sale_20260407_001",
    "processed_at": "2026-04-07T14:22:30.000Z"
}

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

Data ingestion health check

Submit a repayment event