Order Moderation

Request order refund approval

POST/api/v1/orders/admin/:id/refund/request-approval

Starts the OTP-gated refund flow for an order — emails a verification code to the admin.

Requires Authorization

ADMIN only

Payout OTP

Path parameters

idstringrequired

Order ID.

Request

curl --request POST \
  --url https://api.swiftgoma.com/api/v1/orders/admin/:id/refund/request-approval \
  --header 'Authorization: Bearer <access_token>'

200Example response

{
  "success": true,
  "data": {
    "pendingId": "9f8e7d6c-5b4a-3210-9f8e-7d6c5b4a3210",
    "message": "Un code de vérification a été envoyé à admin@swiftgoma.com.",
    "expiresInMinutes": 5
  }
}