POST /api/v1/payouts/:id/cancel

X-API-Key: sk_live_abc123def456
X-API-Secret: your-secret-here

{
  "id": "pyt_xyz789abc",
  "reference_id": "PAY_2024_001",
  "status": "cancelled",
  "amount": 100.00,
  "currency": "USD",
  "fees": 1.50,
  "total_amount": 101.50,
  "beneficiary": {
    "email": "john.doe@example.com",
    "first_name": "John",
    "last_name": "Doe",
    "country": "US"
  },
  "description": "Bonus Payment",
  "created_at": "2024-01-15T10:30:00Z",
  "cancelled_at": "2024-01-15T10:32:00Z",
  "events": [
    {
      "event_type": "status_change",
      "from_status": null,
      "to_status": "created",
      "actor_type": "system",
      "message": "Payout created",
      "created_at": "2024-01-15T10:30:00Z"
    },
    {
      "event_type": "status_change",
      "from_status": "created",
      "to_status": "cancelled",
      "actor_type": "client",
      "message": "Payout cancelled by client",
      "created_at": "2024-01-15T10:32:00Z"
    }
  ]
}

{
  "error": "BadRequest",
  "message": "payout cannot be cancelled in current status"
}

{
  "error": "BadRequest",
  "message": "payout has already been completed"
}

{
  "error": "BadRequest",
  "message": "Payout ID is required"
}

{
  "error": "NotFound",
  "message": "Payout not found"
}

{
  "error": "UnauthorizedAccess",
  "message": "Authentication required"
}

curl -X POST "{{host}}/api/v1/payouts/pyt_xyz789abc/cancel" \
  -H "X-API-Key: sk_live_abc123def456" \
  -H "X-API-Secret: your-secret-here"