Handle OAuth callback

POST

/api/merchants/platforms/callback

Processes the OAuth callback after user authorization on the marketplace.

Flow:

User authorized on marketplace OAuth page

Marketplace redirects to callback URL with code and state parameters

This endpoint exchanges the authorization code for access tokens

Connection is activated and data sync begins

Parameters:

state: The connection ID from the initial connect request

code: Authorization code from the marketplace OAuth flow

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Query Params

Responses

🟢200

application/json

OAuth flow completed successfully, platform connected

Body

🟠400

🟠401

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.dev.opensylo.com/api/merchants/platforms/callback?state&code' \
--header 'Authorization: Bearer <token>'

Response Example

{
    "platformId": "chowdeck",
    "connectionStatus": "NOT_CONNECTED",
    "isActive": true,
    "lastSyncAt": "2024-01-20T15:30:00.000Z",
    "metrics": {
        "totalSales": 2500000,
        "totalOrders": 456,
        "lastOrderDate": "2024-01-20T14:25:00.000Z"
    }
}

Modified at 2025-12-30 08:04:15

Update marketplace credentials