API: `syncMerchants`
POST /v1/syncMerchantsRequest Payload
| Key | Type | Description |
|---|---|---|
command | string | The action to perform: "create", "update", or "delete". |
info | object | The full Merchant data object. For delete, only the id is required. |
Sample Request Body
{
"merchants": [
{
"command": "create",
"info": {
"id": "mer_new_coffee_shop",
"name": "Jeddah Coffee Corner",
"updated_at": "2025-10-16T15:00:00Z"
}
},
{
"command": "delete",
"info": {
"id": "mer_old_store_123"
}
}
]
}Response Payload
Sample Error Response
{
"status": "partial_failure",
"errors": [
{
"id": "mer_new_coffee_shop",
"error": {
"code": "VALIDATION_ERROR",
"message": "Field 'legal_name' cannot be empty."
}
}
]
}