Refunds
POSTCreate and track full or partial refunds for Marketplace payments.
/refundsAuthentication
OAuth 2.0
Permissions
payments:write
Rate limit
120 requests / min
Response
201 Created
Overview
Create and track full or partial refunds for Marketplace payments.
Endpoint
POST /refunds
POST https://api.mediloop.com/v1/refunds
Authorization: Bearer $ACCESS_TOKEN
X-Tenant-Id: $TENANT_IDAuthentication
Required scope:
payments:write. Access is also constrained by seller organization, tenant membership and Marketplace entitlement.Request body
| Field | Type | Required | Description |
|---|---|---|---|
idempotency_key | string | Recommended | Prevents duplicate business actions |
reference_id | string | Varies | Related Marketplace resource |
metadata | object | No | Integration metadata |
Example request
cURL
curl -X POST "https://api.mediloop.com/v1/refunds" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"metadata":{"source":"erp"}}'Example response200 OK
{
"data": {
"id": "mkt_123",
"status": "created",
"updated_at": "2026-08-19T07:00:00Z"
}
}Example response
Marketplace responses use stable resource IDs and explicit lifecycle states so integrations can reconcile safely.
Responses
| HTTP | Meaning |
|---|---|
200 | Success |
201 | Created |
400 | Invalid request |
401 | Authentication required |
403 | Insufficient permissions |
404 | Resource not found |
409 | Business-state conflict |
429 | Rate limit exceeded |